Releases: jtCodes/lyrictor
v1.5.0
Lyrictor 1.5.0
1.5.0 introduces the first version of AI-assisted workflow in Lyrictor. You can now generate a starting point for a lyric video from your existing lyrics, then either replace the current text timeline or apply targeted updates to what you already have.
What’s new
- Added a new AI tab in the editor for AI-assisted timeline generation.
- Added AI starting-point generation from existing project lyrics and LRCLIB lyrics.
- Added two AI apply modes:
Replacefor rebuilding the text timeline.Updatefor making focused changes to the current timeline.
- Added support for AI-driven text updates, including styling and effects on existing lyric items.
- Added optional AI element add-ons for visual elements like visualizer, particles, and light.
- Added an option to include album art as visual reference during AI generation.
- Added model selection and OpenRouter pricing/cost display in the AI workflow.
Improvements
- Improved lyric source handling with better timeline offset and duration awareness.
- Improved source summaries so AI generation reflects the current project window more clearly.
- Improved apply actions with clearer labels, icons, and replace/update distinction.
- Improved layout of the AI panel, including fuller-width controls and cleaner action placement.
- Added browser compatibility info and browser tracking for saved and published projects.
- Improved image manager layout and related editor panel behavior.
Effects and visual updates
- Added a new
Directional Fadetext effect with customizable settings. - Improved text effect foundations and animation state handling.
- Improved opacity handling across lyric rendering and text effects.
- Updated Water Distortion and Ash Fade behavior.
- Added better preview behavior for immersive backgrounds, including resolution and editing mode awareness.
Performance and compatibility
- Added Safari detection and particle scaling adjustments for better performance.
- Added
disableAnimationsupport in multiple rendering paths for improved performance control. - Improved rendering behavior in text, visualizer, particle, and light preview surfaces.
Fixes
- Improved color picker positioning and visibility handling.
- Fixed several timeline/editor interaction details around lyric customization and rendering behavior.
- Improved consistency in applying effect settings and opacity-related behavior.
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.
v1.4.0
Release Notes
Version 1.4.0 brings a substantial editor update focused on richer lyric styling, new motion effects, stronger media controls, and better project creation flows.
What’s New
- Added two new lyric effects: Floating and Water Distortion, with customizable settings in the editor.
- Expanded lyric text styling with letter spacing, text case controls, fill opacity, glow blur, glow color, and a larger set of variable font families.
- Added all-text preview overlays, preview grid overlays, and improved text drag alignment for more precise layout work.
- Introduced light elements on the timeline, including base opacity, motion amount, broader positioning ranges, and animated light previews.
- Added image motion improvements including dance effects, adjustable speed, sway direction, rotation controls, selection overlays, drag handles, and edge feathering.
- Added timeline looping and improved timeline clipping, viewport handling, and smooth scrolling in effect rows.
- Added preview effects support for the audio visualizer with a dedicated preview surface and toggle.
Project and Playback Improvements
- Added Apple Music discovery tools, including top songs browsing, preview playback, carousel navigation, and song search.
- Improved project creation by refining stream URL handling and restoring local file upload support.
- Added project source links with YouTube and Apple Music icons.
- Improved project access handling for desktop-required projects and editing permissions.
- Added local project indicators, clearer ownership logic, and safer deletion behavior.
- Added auto-replay for audio players and improved playback controls and seek interactions.
Other Improvements
- Added a homepage sign-in call to action with Google authentication.
- Cleaned up several editor and profile UI details.
- Updated README visuals and added internal reference docs for text customization and YouTube styling guidance.
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.
Full Changelog: v1.3.0...v1.4.0
v1.3.0
Quick summary: Version 1.3.0 builds on 1.2.0 with a major upgrade to the editor, especially around timeline elements, text effects, and customization controls. It adds stronger support for visualizer and particle workflows, expands creative effect options, and improves polish across previews, project views, and desktop app behavior.
- Adds unified timeline support for visualizer and particle elements, with clearer labels, icons, colors, and selection behavior.
- Improves timeline feedback for disabled items, including dimmed appearance, “OFF” state labeling, and clearer visual indicators when rendering is turned off.
- Introduces new item opacity and render enable/disable controls for lyric and text items, including support for multi-select batch editing.
- Expands lyric effects with new Ash Fade, Glitch, and Blur effects, along with better shared controls for timing, direction, and configuration.
- Enhances particle editing with more control over motion, direction, count, size, sparkle behavior, and animation settings.
- Improves preview and export handling for non-text layers, mixed timeline content, and opacity behavior.
- Refines element-related UI and terminology for better clarity, including improved settings presentation and updated “Elements” labeling.
- Improves visualizer setup and effect-related internals with refactors that make behavior more consistent and maintainable.
- Adds broader UI polish across the app, including updates to homepage layout, project cards, published project views, and playback overlays.
- Improves desktop app flows with update-checking support and related profile/account UI enhancements.
- Adds dynamic metadata generation for published projects and strengthens safeguards around publishing projects that use local audio files.
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.
v1.2.0
Lyrictor 1.2.0
1.2.0 adds a full text effects system, expands lyric styling controls, improves editor usability, and fixes several regressions in saving and settings behavior.
- New text effects:
Spark Fade,RGB Glitch, andText Blur. - New effect controls: timing, direction, fade behavior, sparkle amount, particle sharpness, flicker speed, and per-effect removal.
- New reusable effects framework: effects are now managed in a more flexible way so future effects can be added more consistently.
- Improved right-side settings UI: cleaner hierarchy, better slider styling, more consistent spacing, and better fit in narrow panels.
- New visualizer blur setting with updated preview behavior.
- New editor action:
Fit To Audio, which sets the selected item to span the full audio duration. - Demo project save flow fixed: saving demo projects now properly supports the clone-on-save workflow again.
- Multiple fixes for effect timing, reverse/direction behavior, slider layout issues, legacy visualizer setting compatibility, and visualizer/image settings stability.
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.
v1.1.1
This update improves the project info sidebar and overall project page layout, with a focus on reusability, responsiveness, and cleaner UI behavior.
Highlights
- Refactored the project info sidebar into a reusable
ProjectInfoSectioncomponent. - Improved published project page layout logic for better responsiveness across desktop and mobile.
- Updated project cards to better support flexible layouts.
- Simplified card styling for a cleaner visual treatment.
Component Refactoring
- Extracted the project info sidebar from the published project page into a reusable
ProjectInfoSection. - Expanded
ProjectInfoSectionto support additional configuration, including:hiddenRowstruncateText
- Improved maintainability and consistency by centralizing project info rendering in one shared component.
Layout and Responsiveness
- Updated preview sizing logic on the published project page.
- Added clearer layout constraints with side padding and minimum preview sizes based on device type.
- Improved the desktop/mobile behavior of the published page for more stable and predictable rendering.
UI/UX Improvements
- Added a
fillAvailableWidthprop toProjectCard. - Updated card layout behavior so project cards can expand to fill available space when needed.
- Adjusted the filter pill positioning for better alignment and spacing.
Styling Changes
- Simplified the
.cardbackground styling. - Removed the project card hover glow / hover box-shadow for a cleaner, less noisy appearance.
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.
v1.1.0
Release Notes
This release improves the desktop app experience with built-in update management, better Electron-to-renderer integration, and a cleaner profile menu flow for both signed-in and guest users.
Highlights
- Added desktop update checking directly from the profile menu.
- Added download progress and update status feedback in a dedicated modal.
- Expanded desktop APIs exposed to the renderer for app info and media utilities.
- Improved local media path handling and compatibility with legacy file URLs.
- Refined the profile dropdown and desktop sign-in experience.
What’s New
-
Desktop update management
- Users can now check for updates from the profile dropdown.
- A new desktop update modal shows availability, progress, and download status.
- The latest desktop release can be downloaded directly from the app.
-
Profile menu improvements
- The profile dropdown has been reworked for a smoother experience.
- Signed-in and guest users now see more appropriate menu options and avatar states.
- Desktop-specific actions are integrated more cleanly into the account menu.
-
New Electron desktop APIs
- Added app info access from the renderer.
- Added APIs for retrieving and opening the YouTube cache directory.
- Extended the desktop bridge so these capabilities are available through
lyrictorDesktop.
-
Better media path handling
- Improved local media path resolution in the Electron main process.
- Added support for legacy file URL handling.
- Error handling is clearer and more resilient when resolving local media.
-
Desktop sign-in and navigation polish
- Added a desktop sign-in success modal for clearer authentication feedback.
- Refined profile-page navigation with a reusable navbar and improved back behavior.
Summary
This update makes the desktop app feel more self-contained and reliable by improving update workflows, tightening desktop API support, and polishing profile and sign-in interactions.
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.
v1.0.0
Summary
Lyrictor 1.0.0 marks the move out of beta and expands the app from a browser-only experience into a full desktop and browser-based creation tool. This release brings native desktop support, desktop Google sign-in, YouTube URL importing, stronger playback and source handling, LRCLIB-powered lyric sync, and a substantial round of timeline, editing, and UX improvements across the app.
- Full desktop app support with native Electron packaging for macOS
- Desktop Google sign-in flow for the Electron app
- YouTube URL import with desktop audio resolution, caching, and improved playback handling
- Local file playback support alongside URL-based sources
- LRCLIB lyric fetching and sync tools, including timeline offset and replace flows
- Major audio timeline upgrades, including playhead dragging, hover feedback, zoom improvements, and resizable timeline layout
- Better lyric editing controls with multi-select text customization, centering tools, and word stack conversion
- Improved project browsing and source awareness with better project list behavior and source tags
- New reusable modal system plus better user settings and desktop-required guidance
- Stronger loading, playback error, and general UX polish across the editor and published views
Full Changelog: v1.0.0-beta.2...v1.0.0
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.
v1.0.0-beta.2
What's New
This release makes Lyrictor much stronger as both a creation tool and a sharing platform.
Share and showcase projects
- Publish projects to Discover and share them through dedicated public project pages.
- Create a public username and profile page to showcase your published work.
- Manage published projects more easily with publish, unpublish, and delete actions directly from project cards.
Faster project setup
- Create projects from Apple Music song and album links (preview links only).
- Pick a specific track from an Apple Music album before starting.
- Add artist and song details during project creation for better organization and presentation.
Better editing workflow
- Use the new timeline list view to edit lyric timing in a faster, more structured way.
- Move multiple lyric blocks at once and use improved timeline editing tools like cut and undo flows.
- Handle overlapping lyric timing more cleanly with better level management and placement behavior.
Stronger lyric syncing and navigation
- Follow the current lyric more easily with improved lyric reference highlighting and context-aware matching.
- Seek and review timing more accurately with improved timeline controls.
- Work more comfortably in dense projects with better zoom behavior, ruler readability, and scrollbar interactions.
UI and polish
- Refined project cards, homepage presentation, and editor layout for a cleaner overall experience.
- Improved responsiveness and animation timing across key parts of the app.
- Better visual feedback for saved state, playback, and project status.
What's Changed
- feat: add back navigation button to LyricEditor for improved user exp… by @jtCodes in #148
- Add user profiles, published projects, and Firestore security rules by @jtCodes in #149
- feat: implement tab navigation for published and user projects in Pro… by @jtCodes in #150
- feat: conditionally render edit option in ProjectCard for project owners by @jtCodes in #151
- style: update text styling in Homepage for improved readability by @jtCodes in #152
- Enhance project editing and improve ProfileAvatar integration by @jtCodes in #153
- Editor styling by @jtCodes in #154
- feat: add logout button to SetUsernameModal and reset auth state on u… by @jtCodes in #155
- feat: remove favicon.ico file to streamline project assets by @jtCodes in #156
- feat: reduce transition durations across multiple components for impr… by @jtCodes in #157
- Enhance UI consistency and styling across LyricEditor and components by @jtCodes in #158
- Enhance AudioTimeline and Timeline components for improved user interaction by @jtCodes in #159
- Editor styling by @jtCodes in #160
- feat: update canonical URLs and sitemap to reflect new domain by @jtCodes in #161
- feat: enhance README with detailed features and improved descriptions by @jtCodes in #162
- Enhance ProjectCard layout and styling for improved responsiveness by @jtCodes in #163
- Enhance Apple Music integration and improve audio timeline features by @jtCodes in #164
- Add support for moving multiple lyrics and update README clarity by @jtCodes in #165
- feat: update README to clarify publishing features and enhance user u… by @jtCodes in #166
- Add timeline list view popup with lyric reference and playback cues by @jtCodes in #167
- feat: improve window size handling in useWindowSize hook by @jtCodes in #168
Full Changelog: v1.0.0-beta.1...v1.0.0-beta.2
v1.0.0-beta.1
Lyrictor 1.0.0
Project Management
- Create projects with local audio files or stream URLs
- Two aspect ratios: 16:9 (landscape) and 9:16 (portrait/vertical)
- Two editing modes: Custom (free positioning) and Vertical Scrolled (Apple Music-style auto-scroll)
- Save/load to cloud (Firebase) or browser localStorage
- Keyboard save (Cmd/Ctrl+S), unsaved changes indicator, and tab-close warning
- Demo projects for onboarding
Authentication
- Google OAuth sign-in with cloud sync
- Storage preference toggle (cloud vs local)
Audio Timeline
- Waveform visualization with playback controls and seeking
- Add lyrics, images, and visualizers as timeline items
- Drag, resize, and layer items across multiple tracks
- Multi-select, copy/paste, undo/redo
- Zoom and horizontal/vertical scrolling
Lyrics
- Reference panel with rich text editor — paste full lyrics and highlight-to-add
- Per-text customization: font, size, weight, color, shadow/blur, positioning
Audio Visualizer
- Circle and vignette variants with radial gradients
- Beat-synced intensity driven by real-time frequency analysis
- Custom color stops with album art color extraction
Images
- Import images via URL with position and scale controls
- AI image generation via local Stable Diffusion or OpenRouter (GPT-5 Image, Gemini, etc.)
- Prompt editor, negative prompts, generation log, and advanced parameters (seed, sampler, CFG, steps)
Canvas Preview
- Live real-time preview synced to audio playback
- Fullscreen mode
- Aspect-ratio-aware scaling
Video Export
- Export to MP4 at 1080p (1920×1080 or 1080×1920)
- Composites visualizers, lyrics, images, and audio
- Progress tracking with cancel option
Editor UI
- Resizable and collapsible side panels (media/lyrics left, settings right)
- Back-to-home navigation
- Featured project showcase on homepage