Dockable Markdown Viewer for REAPER DAW
Scenario linking, teleprompter mode, and AI-powered text formatting
Features • Installation • Usage • AI Parse • Screenshots • License
Note
Tested on macOS Tahoe 26.2. Windows and Linux support is expected but not yet verified. Contributions and feedback from other platforms are welcome!
ReaMD is a dockable markdown viewer designed specifically for audio production workflows in REAPER. It bridges the gap between your scripts, notes, and the timeline - allowing you to link text fragments directly to items on your tracks.
Perfect for:
- Voiceover production - Link script lines to VO recordings
- Audio post-production - Sync scene descriptions with sound design
- Podcast editing - Follow show notes while editing
- Music production - Keep lyrics and arrangement notes in view
- Full markdown rendering (headers, lists, tables, code blocks, blockquotes)
- Edit mode - Write and modify markdown directly in REAPER
- Dark & Light themes - Seamlessly match your REAPER theme
- Dockable window - Integrate into your workflow
- Link text fragments to timeline items - Click a paragraph, jump to the item
- Multi-item support - One fragment can reference multiple items
- Category colors - V (Voiceover), M (Music), F (FX), O (Other)
- Group awareness - REAPER item groups treated as single units
- Visual feedback - Linked fragments highlighted, playback position tracked
- VO-focused display - Shows only voiceover text, large and centered
- Auto-scroll - Follows playback position automatically
- Progress indicator - Orange (next cue) / Green (current item ending)
- Semi-transparent overlay - 50% opacity, stays out of the way
- Paste unformatted text - Meeting notes, raw scripts, brain dumps
- AI formats to markdown - Clean structure with proper headings and lists
- Customizable prompt - Tailor the AI behavior to your workflow
- Non-blocking - Async processing, UI stays responsive
| Component | Version | Required |
|---|---|---|
| REAPER | 7.0+ | Yes |
| ReaImGui | 0.10+ | Yes |
| js_ReaScriptAPI | Latest | Recommended |
| SWS Extension | Latest | Recommended |
-
Add ReaMD repository to ReaPack:
- Open REAPER → Extensions → ReaPack → Import repositories...
- Paste:
https://github.com/b451c/ReaMD/raw/main/index.xml - Click OK
-
Install ReaMD:
- Extensions → ReaPack → Browse packages
- Search for "ReaMD" → Right-click → Install
- Apply and restart REAPER
-
Run:
- Actions → Show action list
- Search for "ReaMD"
- Double-click to run (or assign shortcut)
-
Download the latest release or clone:
git clone https://github.com/b451c/ReaMD.git
-
Copy to REAPER Scripts folder:
Windows: %APPDATA%\REAPER\Scripts\ReaMD\ macOS: ~/Library/Application Support/REAPER/Scripts/ReaMD/ Linux: ~/.config/REAPER/Scripts/ReaMD/ -
Load the script:
- REAPER → Actions → Load ReaScript
- Select
Main/ReaMD.lua
Tip: For full functionality, install ReaImGui, js_ReaScriptAPI, and SWS Extension.
- Open a markdown file - Click "Open..." or drag & drop
- Dock the window - Right-click title bar → Dock
- Browse your script - Scroll, search, navigate headings
- Enter Scenario Mode - Toggle "Scenario" in toolbar
- Select items on timeline - The items you want to link
- Click [+] on a text fragment - Links selected items to that text
- Click linked text - Jumps to and selects the items
- Play - Text highlights follow playback position
- Set up scenario links - At least link your VO items
- Click "Teleprompter" - Opens focused display window
- Start playback - Text auto-scrolls with timeline
Transform unstructured text into clean markdown using Claude AI.
- Get an API key from Anthropic Console
- In ReaMD, open Settings (gear icon)
- Paste your API key in the "AI Parser Settings" section
- Click New → AI Parse...
- Paste your unformatted text
- Click Parse with AI
- Review the result → Save As...
Click Edit Prompt in settings to modify prompts/ai_format_prompt.txt. Tailor it for your specific use case (voiceover scripts, technical docs, meeting notes, etc.).
Note: AI Parse requires an internet connection and uses the Claude Haiku model for fast, cost-effective processing.
Dark & Light Themes
Settings Panel
AI Parse Window
ReaMD/
├── Main/
│ └── ReaMD.lua # Main script (run this)
├── Libs/
│ ├── ai_parser.lua # AI integration module
│ ├── config.lua # Settings management
│ ├── json.lua # JSON encoder/decoder
│ ├── md_parser.lua # Markdown parser
│ ├── md_renderer.lua # ReaImGui renderer
│ ├── scenario_engine.lua # Timeline linking engine
│ ├── teleprompter.lua # Teleprompter mode
│ └── utils.lua # Utility functions
└── prompts/
└── ai_format_prompt.txt # Customizable AI prompt
Install ReaImGui via ReaPack: Extensions → ReaPack → Browse packages → Search "ReaImGui"
- Verify your API key is correct in Settings
- Check internet connection
- On Windows, ensure
curlis available (comes with Windows 10+)
- Ensure scenario links are set up (fragments linked to timeline items)
- Check that linked items exist on the timeline
Contributions are welcome! Please feel free to submit issues and pull requests.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- ReaImGui by cfillion - Amazing ImGui bindings for REAPER
- REAPER by Cockos - The best DAW for scripting
- Anthropic - Claude AI for text formatting
Made with ❤️ for the REAPER community
