Liner

Modern desktop music streaming player with syllable-synced lyrics and reactive dynamic visuals.

Preview • Architecture • Getting Started • Building • Contributing • License

---

Preview

Home	Fullscreen mode

---

Note

Liner client connects to the official Liner API backend for music catalog, streaming playback, and synchronized lyrics.

---

Architecture

liner/desktop/
├── electron/
│   ├── main.ts              # Electron main process & IPC handlers
│   ├── preload.ts           # Context bridge & secure renderer bindings
│   ├── crypto.ts            # High-performance in-memory WebAssembly signer
│   └── signer.ts            # Embedded WebAssembly binary
├── src/
│   ├── assets/              # Static assets and media
│   ├── components/          # Shared reusable UI components
│   ├── features/            # Feature modules (player, lyrics, queue, library, search, auth)
│   ├── pages/               # Route views (Home, Search, Album, Artist, Playlist)
│   ├── shared/              # API client, state stores (Zustand), and data contracts
│   ├── App.tsx              # Application root
│   └── main.tsx             # Vite entry point
├── package.json
└── vite.config.ts

---

Getting Started

Prerequisites

• Node.js v20+ and pnpm or Bun
• Modern OS (Windows 10/11, macOS, or Linux)

---

Setup

# 1. Clone repository
git clone https://github.com/tryliner/desktop.git
cd desktop

# 2. Install dependencies (pnpm or Bun)
pnpm install
# or
bun install

---

Running in Development

# Start Liner in development mode (Electron app with Vite hot-reload)
pnpm run dev
# or
bun run dev

---

Testing

# Run test suite with Vitest
bun run test
# or
pnpm test

---

Building

# Build desktop packages for your current OS:

# Linux (AppImage & .deb)
bun run electron:build:linux

# Windows (.exe installer)
bun run electron:build:win

Compiled distributions will be placed in the release/ directory.

---

Contributing

Bug fixes, small features, and docs fixes are welcome. Read CONTRIBUTING.md before you open a pull request. The license limits what a fork is allowed to do.

---

Special Thanks

• @braccato/core & @braccato/parsers — Synced lyrics components and format parsers.
• @kawarp/react & @kawarp/core — WebGL background shader components.
• Solar Icons & MingCute Icons — Icon collections.

---

License

Liner is distributed under the Liner Source-Available & Non-Commercial Contribution License.

• Allowed: Personal non-commercial usage, local builds, and upstream contributions.
• Prohibited: Commercial distribution, public competing forks, or extracting core algorithms for third-party products.

See LICENSE for details.