https://github.com/aelithron/lyrickit

Simple toolkit for everything to do with song lyrics. Find, write, and sync lyrics for existing songs with ease.
https://github.com/aelithron/lyrickit

lrclib lyrics music nextjs

Last synced: about 1 month ago
JSON representation

Simple toolkit for everything to do with song lyrics. Find, write, and sync lyrics for existing songs with ease.

• Host: GitHub
• URL: https://github.com/aelithron/lyrickit
• Owner: aelithron
• License: mit
• Created: 2025-10-24T22:35:12.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2026-05-13T01:13:15.000Z (2 months ago)
• Last Synced: 2026-05-28T00:28:06.130Z (about 2 months ago)
• Topics: lrclib, lyrics, music, nextjs
• Language: TypeScript
• Homepage: https://lyrics.novatea.dev
• Size: 301 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# LyricKit ![IMG](https://hackatime-badge.hackclub.com/U08RJ1PEM7X/lyrickit)

A one-stop-shop webapp for everything related to lyrics! \

Download, write, sync, and export lyrics to be usable where you need them. \

This project was made for Moonshot, a Hack Club event!



  

    

  



## Features

- Metadata extractor for uploaded song files

- Pulls existing lyrics from LRCLIB

- Includes a simple tool for playing a song and syncing while you do so, inspired by https://lrc-maker.github.io.

- Works with bulk imports (drop a bunch of songs in, pull/write/sync lyrics, and export a .zip at the end).

- Mobile compatibility

- Supports many file types

## Usage

Go to [lyrics.novatea.dev](https://lyrics.novatea.dev) in a web browser! Upload your songs and follow the flow illustrated by the sidebar (it goes in order).

### Self-hosting

#### With Docker Compose

Copy the following Compose file to your server or computer, and name it `compose.yaml`:

```yaml

services:

  lyrickit:

    image: ghcr.io/aelithron/lyrickit:latest

    container_name: lyrickit

    ports:

      - "3000:3000"

    restart: unless-stopped

```

Then, simply run `docker compose up -d` in the directory of the file!

#### With `docker run`

Run the following command on your server or computer:

```bash

docker run -d \

  --name lyrickit \

  -p 3000:3000 \

  --restart unless-stopped \

  ghcr.io/aelithron/lyrickit:latest

```

## Credits

This project uses some [Font Awesome](https://fontawesome.com) and [Twemoji](https://github.com/twitter/twemoji) icons throughout.