https://github.com/jtcodes/lyrictor
High-performance lyric video editor accessible on any browser
https://github.com/jtcodes/lyrictor
ai editor howlerjs konvajs lyrics music react react-spectrum song song-lyrics stable-diffusion typescript waveform waveform-data webapp zustand
Last synced: 2 months ago
JSON representation
High-performance lyric video editor accessible on any browser
- Host: GitHub
- URL: https://github.com/jtcodes/lyrictor
- Owner: jtCodes
- License: gpl-3.0
- Created: 2022-02-18T14:09:36.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-11-10T05:58:53.000Z (over 1 year ago)
- Last Synced: 2025-06-05T09:42:10.493Z (12 months ago)
- Topics: ai, editor, howlerjs, konvajs, lyrics, music, react, react-spectrum, song, song-lyrics, stable-diffusion, typescript, waveform, waveform-data, webapp, zustand
- Language: TypeScript
- Homepage: https://lyrictor.vercel.app
- Size: 2.35 MB
- Stars: 37
- Watchers: 2
- Forks: 9
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Lyrictor
Lyrictor is a desktop and browser-based creative tool for turning personal interpretations of songs, including songs imported from YouTube URLs, into shareable visual experiences. Songs already mean something personal, and Lyrictor lowers the cost and friction of turning that feeling into something beautiful with a magnetic-style timeline, beat-reactive visuals, built-in AI image generation, and YouTube URL support.
Interpret, create, publish.
## Why Lyrictor
- Timeline-first creation built for shaping a song's emotional arc
- Native lyric syncing and layered timeline items (text, images, visualizer blocks)
- AI image generation directly inside the creative flow
- Two creative modes: free layout and Apple Music-style vertical sync mode
- Publishing built for sharing and revisiting interpretations over time
## Standout Features
### AI Image Generation (Built In)
- Generate backgrounds and scene images from prompts without leaving your project
- OpenRouter image model support (including Gemini and GPT image models)
- Optional local Stable Diffusion support
- Prompt history and generated image log for fast iteration and reuse
- Prompt suggestion flow for faster creative ideation
### Timeline Creation
- Interactive waveform timeline with zoom, pan, and precise placement
- Layered timeline levels for overlapping visual moments
- Collision-aware lane behavior for cleaner sequencing
- Multi-select creation and timeline-driven text, image, and visualizer control
### Source Support
- Import songs from YouTube URLs
### Two Editing Modes
- Free mode: move and style lyric text anywhere on canvas
- Static sync mode: Apple Music-style vertical scrolling lyric presentation
### Beat-Reactive Visualizer
- Audio-reactive visualizer blocks on the same timeline as lyrics
- Real-time intensity changes driven by audio analysis
### Publishing and Export
- Project save/load and publishing for revisiting and sharing interpretations over time
- In-browser video export for landscape and portrait formats
## Demo
Stephen Sanchez - Until I Found You
[](https://www.youtube.com/watch?v=To29kD8vPoI)
Lyrictor + AI (Preview)
[](https://www.youtube.com/watch?v=6oVsjVHntP8)
## Tech Stack
- React + TypeScript
- React Spectrum
- Zustand
- Konva
- waveform-data
- react-use-audio-player + Howler
- Firebase (auth + data)
## Desktop App
Lyrictor is available as an Electron desktop app in addition to the browser version, with YouTube URL support and local playback workflows.
Download the latest desktop release here:
https://github.com/jtCodes/lyrictor/releases
> [!WARNING]
> The current macOS desktop build is not yet notarized by Apple, so macOS may warn that Lyrictor cannot be verified. If that happens, right-click the app in Finder, choose **Open**, and confirm the prompt, or allow it in **System Settings > Privacy & Security**.
## Local Development
Web:
```bash
yarn dev
```
Desktop Electron:
```bash
yarn dev:desktop
```
Build for production:
Web:
```bash
yarn build
```
Desktop Electron:
```bash
yarn dist:desktop
```
## Roadmap
- More text animation presets and transitions
- Richer timeline interactions and creative control
- Expanded sharing and discovery around musical interpretation