Skip to content

jtCodes/lyrictor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,182 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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. Screenshot 2026-03-31 at 1 05 57 PM Screenshot 2026-03-31 at 1 07 09 PM Screenshot 2026-03-17 at 10 12 56 PM Screenshot 2026-03-19 at 3 48 39 PM

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

Demo video

Lyrictor + AI (Preview)

AI demo video

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

This repo is pinned to Yarn 4. Enable Corepack, then install dependencies:

corepack enable
yarn install --immutable

For CI or any reproducible install, use:

yarn install --immutable

Web:

yarn dev

Desktop Electron:

yarn dev:desktop

Build for production:

Web:

yarn build

Desktop Electron:

yarn dist:desktop

Roadmap

  • More text animation presets and transitions
  • Richer timeline interactions and creative control
  • Expanded sharing and discovery around musical interpretation

About

Desktop and browser-based creative tool for turning personal interpretations of songs into shareable visual experiences.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors