{"id":48779735,"url":"https://github.com/lisaross/tana-tools","last_synced_at":"2026-04-13T13:34:24.148Z","repository":{"id":299893498,"uuid":"1004538878","full_name":"lisaross/tana-tools","owner":"lisaross","description":"Raycast extension for converting content to Tana format","archived":false,"fork":false,"pushed_at":"2025-07-10T19:35:02.000Z","size":6421,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-10T22:06:08.335Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lisaross.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T19:34:52.000Z","updated_at":"2025-07-10T19:35:05.000Z","dependencies_parsed_at":"2025-06-18T21:31:03.728Z","dependency_job_id":"d1d37524-95b7-42f9-8b13-7fe352cf3e16","html_url":"https://github.com/lisaross/tana-tools","commit_stats":null,"previous_names":["lisaross/tana-tools"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/lisaross/tana-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Ftana-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Ftana-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Ftana-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Ftana-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lisaross","download_url":"https://codeload.github.com/lisaross/tana-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lisaross%2Ftana-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31755148,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T13:27:56.013Z","status":"ssl_error","status_checked_at":"2026-04-13T13:21:23.512Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-13T13:34:10.016Z","updated_at":"2026-04-13T13:34:24.132Z","avatar_url":"https://github.com/lisaross.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tana Tools\n\n🚀 **Instantly convert web pages (mostly), YouTube videos, and text (including Markdown) to Tana Paste format from Raycast**\n\nTransform any content into Tana's structured format with just a few keystrokes. Perfect for knowledge workers, researchers, and anyone building their second brain in Tana.\n\n![Raycast Extension](https://img.shields.io/badge/Raycast-Extension-FF6363)\n![License](https://img.shields.io/badge/License-MIT-blue)\n\n\u003e **💡 Tip:** Web-based commands require the [Raycast Browser Extension](https://raycast.com/browser-extension) - quick setup, works great!\n\n## ✨ What This Extension Does\n\n**Transform any content into Tana's structured format:**\n- 📄 **Web pages** → Clean, formatted Tana nodes with metadata\n- 🎥 **YouTube videos** → Title, description, transcript, and metadata\n- 📝 **Text \u0026 clipboard** → Properly formatted Tana hierarchies\n- 🎙️ **Limitless transcripts** → Smart chunking so Tana limits are respected, and ready for AI review.\n\n**Everything automatically opens in Tana and copies to your clipboard** - just paste with ⌘+V!\n\n## 🎯 Perfect For\n\n- **Researchers** collecting web content and videos\n- **Students** saving lectures and articles  \n- **Knowledge workers** building their PKM system\n- **Content creators** organizing research materials\n- **Anyone** who wants seamless Tana integration\n\n## 🛠 Commands\n\n### 📋 Text \u0026 Clipboard\n- **Quick Clipboard to Tana** - Instantly convert clipboard content (perfect for Limitless transcripts!)\n- **Paste and Edit for Tana** - Review and edit text before converting\n\n### 🌐 Web Content  \n- **Copy Page Content to Tana** - Extract clean content from the active browser tab\n- **Copy Page Content to Tana (Select Tab)** - Choose from any open browser tab\n\n### 🎥 YouTube Integration\n- **YouTube to Tana** - Extract video metadata, descriptions, full transcripts, and video ID for better organization (note: you'll need to open the Transcript on the Youtube page first 😭)\n\n## 🎨 Customization\n\n**10 User Preferences** let you personalize the output:\n- **Custom Tags**: Set your own supertags for videos, articles, transcripts, and notes\n- **Field Names**: Customize field names (URL, Author, Transcript, Content) to match your Tana setup\n- **Content Control**: Toggle whether to include author and description fields\n- **Workflow Integration**: Make the output fit into your existing Tana workflow or use defaults\n\n![Configuration for custom Tana workflows and tags](docs/images/01-Configuration-for-custom-tana-workflows-and-tags.png)\n\n## 🚀 Quick Start\n\n### 1. Install Requirements\n\n**Essential:** Install the [Raycast Browser Extension](https://raycast.com/browser-extension)\n- Works with Chrome, Arc, and Safari\n- Enables all web-based features\n\n### 2. Basic Usage\n\n1. **For web pages:** Open any article → Run \"Copy Page Content to Tana\" → Content appears in Tana\n2. **For YouTube:** Open a video → Click \"more...\" → \"Show transcript\" → Then run \"YouTube to Tana\" → Paste full video info + transcript in Tana\n3. **For text:** Copy anything → Run \"Quick Clipboard to Tana\" → Formatted content in Tana\n\n### 3. Advanced Usage\n\n**Edit Before Converting:** Use \"Paste and Edit for Tana\" to review and modify content first\n\n## 📋 Detailed Setup\n\n### For YouTube Transcripts\n\n1. **Browser Setup:**\n   - **Chrome/Arc:** Works immediately with Browser Extension\n   - **Safari:** Additional setup required:\n     ```\n     Safari Settings → Advanced → ✓ \"Show features for web developers\"\n     Safari Settings → Developer → ✓ \"Allow JavaScript from Apple Events\"\n     ```\n     Then reload the YouTube page\n\n2. **Usage Steps:**\n   - Open any YouTube video\n   - **🔴 IMPORTANT:** Click \"more → Show transcript\" below the video first\n   \n   ![Run YouTube to Tana Command - note transcript must be showing](docs/images/02-Run-Youtube-to-Tana-Command---note-transcript-must-be-showing.png)\n   \n   - Run the Raycast command\n   - Get complete video info + clean transcript text\n   \n   ![Tana Results - YouTube to Tana](docs/images/03-Tana-Results----Youtube-to-Tana.png)\n\n### For Web Content\n\n- Works on any website with the Browser Extension\n- Automatically extracts clean content using reader mode\n- Filters out ads, navigation, and clutter\n- Preserves article structure and formatting\n\n![Run Copy Page Content to Tana from Website](docs/images/04-Run-Copy-Page-Content-to-Tana-from-Website.png)\n\n![Tana Results - Copy Page Content to Tana](docs/images/05-Tana-Results--Copy-Page-Content-to-Tana.png)\n\n**Tab Selection:** Use \"Copy Page Content to Tana (Select Tab)\" to choose from multiple open tabs\n\n![Copy Page Content to Tana (select Tab)](docs/images/06-Copy-Page-Content-to-Tana-(select-Tab).png)\n\n![Clipboard as Tana Paste - Paste and Edit](docs/images/07-Clipboard-as-Tana-Paste---Paste-and-Edit.png)\n\n## 📖 Example Output\n\n**Input:** A web article about productivity\n\n**Output in Tana:**\n```\n%%tana%%\n- How to Build Better Habits #article\n  - URL::https://example.com/habits\n  - Author::James Clear  \n  - Description::Scientific approaches to habit formation\n  - Content::\n    - Introduction\n      - Habits are the compound interest of self-improvement\n      - Small changes compound into remarkable results\n    - The Habit Loop\n      - Cue triggers the behavior\n      - Routine is the behavior itself\n      - Reward reinforces the habit\n```\n\n**YouTube Output Example:**\n```\n%%tana%%\n- How to Learn Anything #video\n  - URL::https://youtube.com/watch?v=abc123\n  - Author::Learning Channel\n  - VideoID::abc123\n  - Description::Master the art of learning\n  - Transcript::\n    - [00:00] Welcome to today's episode\n    - [00:15] Today we'll explore learning techniques\n    - [00:30] First, let's understand how the brain works\n```\n\n**For Limitless Transcripts:**\nJust copy your transcript to clipboard and run \"Quick Clipboard to Tana\" - it automatically detects and formats transcripts with smart chunking!\n\n## 🎨 Features\n\n✅ **Smart Content Detection** - Automatically handles different content types  \n✅ **Clean Formatting** - Removes ads, navigation, and clutter  \n✅ **Rich Metadata** - Captures titles, authors, descriptions, URLs  \n✅ **Transcript Processing** - Smart chunking (7000 chars) with proper boundaries\n✅ **Video ID Tracking** - Captures YouTube video IDs for better organization  \n✅ **Table Support** - Converts HTML tables to markdown format  \n✅ **Link Preservation** - Maintains clickable links in content  \n✅ **Auto Tana Opening** - Seamlessly opens Tana after conversion  \n✅ **Cross-Browser** - Works with Chrome, Arc, and Safari  \n\n## 💡 Pro Tips\n\n- **For YouTube**: Always click \"Show transcript\" below the video first for best results\n- **Manual Transcript**: If automatic extraction fails, you can copy and paste YouTube transcripts manually\n- **For Limitless**: Just copy your transcript text and use \"Quick Clipboard to Tana\"\n- **Customization**: Check Raycast preferences to personalize tags and field names\n- **Safari Users**: Enable developer features in Safari settings for web content extraction\n\n## 📞 Support \u0026 Feedback\n\n- **Issues:** [GitHub Issues](https://github.com/lisaross/tana-tools/issues)\n- **Contact:** Lisa Ross via Slack DM or GitHub\n\n\u003e **Note:** This is an unofficial Tana tool created by Lisa Ross\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details\n\n---\n\n**Made with ❤️ for the Tana community**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flisaross%2Ftana-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flisaross%2Ftana-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flisaross%2Ftana-tools/lists"}