An open API service indexing awesome lists of open source software.

https://github.com/lisaross/tana-tools-for-raycast

Quickly convert text, Markdown, YouTube, and Limitless content to Tana Paste formatβ€”right from Raycast.
https://github.com/lisaross/tana-tools-for-raycast

limitless markdown raycast tana youtube

Last synced: 2 months ago
JSON representation

Quickly convert text, Markdown, YouTube, and Limitless content to Tana Paste formatβ€”right from Raycast.

Awesome Lists containing this project

README

          

# Tana Tools for Raycast

πŸš€ **Instantly convert web pages, YouTube videos, and text (including Markdown) to Tana Paste format from Raycast**

Transform 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.

![Raycast Extension](https://img.shields.io/badge/Raycast-Extension-FF6363)
![License](https://img.shields.io/badge/License-MIT-blue)

> **πŸ’‘ Tip:** Web-based commands require the [Raycast Browser Extension](https://raycast.com/browser-extension) - quick setup, works great!

## ✨ What This Extension Does

**Transform any content into Tana's structured format:**
- πŸ“„ **Web pages** β†’ Clean, formatted Tana nodes with metadata
- πŸŽ₯ **YouTube videos** β†’ Title, description, transcript, and metadata
- πŸ“ **Text & clipboard** β†’ Properly formatted Tana hierarchies
- πŸŽ™οΈ **Limitless transcripts** β†’ Smart chunking so Tana limits are respected, and ready for AI review.

**Everything automatically opens in Tana and copies to your clipboard** - just paste with ⌘+V!

## 🎯 Perfect For

- **Researchers** collecting web content and videos
- **Students** saving lectures and articles
- **Knowledge workers** building their PKM system
- **Content creators** organizing research materials
- **Anyone** who wants seamless Tana integration

## πŸ›  Commands

### πŸ“‹ Text & Clipboard
- **Quick Clipboard to Tana** - Instantly convert clipboard content (perfect for Limitless transcripts!)
- **Paste and Edit for Tana** - Review and edit text before converting

### 🌐 Web Content
- **Copy Page Content to Tana** - Extract clean content from the active browser tab
- **Copy Page Content to Tana (Select Tab)** - Choose from any open browser tab

### πŸŽ₯ YouTube Integration
- **YouTube to Tana** - Extract video metadata, descriptions, and full transcripts (note: you'll need to open the Transcript on the Youtube page first 😭)

## 🎨 Customization

**10 User Preferences** let you personalize the output:
- **Custom Tags**: Set your own supertags for videos, articles, transcripts, and notes
- **Field Names**: Customize field names (URL, Author, Transcript, Content) to match your Tana setup
- **Content Control**: Toggle whether to include author and description fields
- **Perfect Integration**: Make the output fit seamlessly into your existing Tana workflow

![Configuration for custom Tana workflows and tags](docs/images/01-Configuration-for-custom-tana-workflows-and-tags.png)

## πŸš€ Quick Start

### 1. Install Requirements

**Essential:** Install the [Raycast Browser Extension](https://raycast.com/browser-extension)
- Works with Chrome, Arc, and Safari
- Enables all web-based features

### 2. Basic Usage

1. **For web pages:** Open any article β†’ Run "Copy Page Content to Tana" β†’ Content appears in Tana
2. **For YouTube:** Open a video β†’ Click "more..." β†’ "Show transcript" β†’ Then run "YouTube to Tana" β†’ Paste full video info + transcript in Tana
3. **For text:** Copy anything β†’ Run "Quick Clipboard to Tana" β†’ Formatted content in Tana

### 3. Advanced Usage

**Edit Before Converting:** Use "Paste and Edit for Tana" to review and modify content first

## πŸ“‹ Detailed Setup

### For YouTube Transcripts

1. **Browser Setup:**
- **Chrome/Arc:** Works immediately with Browser Extension
- **Safari:** Additional setup required:
```
Safari Settings β†’ Advanced β†’ βœ“ "Show features for web developers"
Safari Settings β†’ Developer β†’ βœ“ "Allow JavaScript from Apple Events"
```
Then reload the YouTube page

2. **Usage Steps:**
- Open any YouTube video
- **πŸ”΄ IMPORTANT:** Click "more β†’ Show transcript" below the video first

![Run YouTube to Tana Command - note transcript must be showing](docs/images/02-Run-Youtube-to-Tana-Command---note-transcript-must-be-showing.png)

- Run the Raycast command
- Get complete video info + clean transcript text

![Tana Results - YouTube to Tana](docs/images/03-Tana-Results----Youtube-to-Tana.png)

### For Web Content

- Works on any website with the Browser Extension
- Automatically extracts clean content using reader mode
- Filters out ads, navigation, and clutter
- Preserves article structure and formatting

![Run Copy Page Content to Tana from Website](docs/images/04-Run-Copy-Page-Content-to-Tana-from-Website.png)

![Tana Results - Copy Page Content to Tana](docs/images/05-Tana-Results--Copy-Page-Content-to-Tana.png)

**Tab Selection:** Use "Copy Page Content to Tana (Select Tab)" to choose from multiple open tabs

![Copy Page Content to Tana (select Tab)](docs/images/06-Copy-Page-Content-to-Tana-(select-Tab).png)

![Clipboard as Tana Paste - Paste and Edit](docs/images/07-Clipboard-as-Tana-Paste---Paste-and-Edit.png)

## πŸ“– Example Output

**Input:** A web article about productivity

**Output in Tana:**
```
%%tana%%
- How to Build Better Habits #article
- URL::https://example.com/habits
- Author::James Clear
- Description::Scientific approaches to habit formation
- Content::
- Introduction
- Habits are the compound interest of self-improvement
- Small changes compound into remarkable results
- The Habit Loop
- Cue triggers the behavior
- Routine is the behavior itself
- Reward reinforces the habit
```

**For Limitless Transcripts:**
Just copy your transcript to clipboard and run "Quick Clipboard to Tana" - it automatically detects and formats transcripts with smart chunking!

## 🎨 Features

βœ… **Smart Content Detection** - Automatically handles different content types
βœ… **Clean Formatting** - Removes ads, navigation, and clutter
βœ… **Rich Metadata** - Captures titles, authors, descriptions, URLs
βœ… **Transcript Processing** - Smart chunking with proper boundaries
βœ… **Table Support** - Converts HTML tables to markdown format
βœ… **Link Preservation** - Maintains clickable links in content
βœ… **Auto Tana Opening** - Seamlessly opens Tana after conversion
βœ… **Cross-Browser** - Works with Chrome, Arc, and Safari

## πŸ’‘ Pro Tips

- **For YouTube**: Always click "Show transcript" below the video first for best results
- **For Limitless**: Just copy your transcript text and use "Quick Clipboard to Tana"
- **Customization**: Check Raycast preferences to personalize tags and field names
- **Safari Users**: Enable developer features in Safari settings for web content extraction

## πŸ“ž Support & Feedback

- **Issues:** [GitHub Issues](https://github.com/lisaross/tana-tools-for-raycast/issues)
- **Contact:** Lisa Ross via Slack DM or GitHub

> **Note:** This is an unofficial Tana tool created by Lisa Ross

## πŸ“„ License

MIT License - see [LICENSE](LICENSE) for details

---

**Made with ❀️ for the Tana community**