Skip to content

HynLcc/Teable-URL-to-Attachment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Teable URL to Attachment

English 简体中文

A Chrome extension that converts URLs into attachments and uploads them to Teable tables.


🚀 Quick Start

How to Use

  1. Open your Teable table page

    • Navigate to your table in the browser
  2. Click the extension icon

    • The extension will auto-detect the current table and view
  3. Select fields

    • View: Choose which records to process (select a specific view or all records)
    • Source Field: Select the text field containing URLs
    • Target Field: Select the attachment field for storing files
  4. Start migration

    • Click "Start Migration" button
    • Wait for the progress bar to complete
    • Refresh the page to see attachments

Source Field Format

Supports comma-separated URL lists:

https://example.com/file1.jpg, https://example.com/file2.pdf

⚠️ Important Notes

  • Do NOT run in multiple tabs simultaneously - May cause duplicate uploads
  • Extension always appends attachments - Does not check for duplicates
  • Running multiple times will duplicate uploads - Recommended to run only once
  • Invalid URLs will be skipped - Check logs for failures

💡 Pro Tips

Tip 1: Use Views to Avoid Duplicates

Create a view with filter: Attachment fieldis empty

This ensures you only upload to records without attachments yet.

Tip 2: Batch Process Large Tables

For tables with thousands of records:

  1. Create multiple views: "Batch 1", "Batch 2", etc.
  2. Run migration on each view separately

Tip 3: Re-upload Failed Records

If some URLs failed to upload:

  1. Create a view filtering empty attachment fields
  2. Re-run the migration

📦 Installation Guide

Step 1: Download the Extension

  1. Visit the GitHub repository: https://github.com/HynLcc/Teable-URL-to-Attachment
  2. Click the green Code button
  3. Select Download ZIP
  4. After downloading, extract to a permanent folder
    • ⚠️ Important: Don't put it in temporary folders or desktop, as deleting it will break the extension
    • Recommended location: Documents/ChromeExtensions/Teable-URL-to-Attachment

Step 2: Open Chrome Extensions Page

Open the extensions management page using either method:

Method 1: Address bar

chrome://extensions/

Method 2: Through menu

  • Click (three dots) in the top-right corner
  • Select ExtensionsManage Extensions

Step 3: Enable Developer Mode

In the extensions page, find the Developer mode toggle in the top-right corner and turn it on (it will turn blue).

Step 4: Load the Extension

  1. Click Load unpacked button in the top-left corner
  2. In the file selection window, choose the folder you just extracted
  3. Click Select Folder

Step 5: Pin to Toolbar (Recommended)

  1. Click the puzzle icon (Extensions) in Chrome's top-right corner
  2. Find Teable URL to Attachment
  3. Click the 📌 icon to pin it to the toolbar
  4. Now you can click the toolbar icon anytime to use the extension!

⚠️ FAQ

Q: Why do I need to enable Developer Mode? A: This extension is currently an open-source project, not published to the Chrome Web Store. Developer mode is required to install non-store extensions.

Q: Is Developer Mode safe? A: Yes, it's safe. You can review the source code of this project to verify there's no malicious code. Developer mode simply allows you to install extensions not reviewed by Chrome.

Q: Extension shows "Error" or doesn't work after installation? A: Please check:

  • Did you select the correct folder (should contain manifest.json file)?
  • Is the folder fully extracted (don't operate on the ZIP file directly)?

Q: Will the extension auto-update? A: No. You need to manually download new versions, remove the old extension, and reload the new one.

Q: Can I use it in other browsers? A: Theoretically yes, for all Chromium-based browsers (Edge, Brave, Opera, etc.). Installation process is similar.


✨ Features

  • View-Based Filtering: Use Teable views to control which records to process
  • Batch Processing: Efficiently handle large datasets with automatic retries
  • Auto-Detection: Automatically detects table and view IDs
  • Append Mode: Does not overwrite existing attachments

🔧 FAQ

Q: "API Host is missing" error A: Manually enter your Teable domain in Advanced Settings (e.g., https://app.teable.ai)

Q: "Context detection error" A: Ensure you're on a table page (URL should contain /table/...), refresh and retry

Q: Uploads keep failing A: Check if URLs are publicly accessible. Extension auto-retries up to 3 times


📄 License

MIT License


📮 Feedback

Feel free to open an issue on GitHub for questions or suggestions.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published