- Local Music Library - Import and manage your music files with ID3 tag support
- Favorites - Mark your favorite tracks for quick access
- Recently Played - Track your listening history
- Theme Customization - Customize colors to match your aesthetic
- Responsive Design - Seamless experience on desktop and mobile
- Dark Mode - Built-in dark mode support
- Minimalist UI - Clean, distraction-free interface inspired by Japanese design
- Shuffle & Repeat - Full playback controls
- Track Editing - Edit metadata for your tracks
- Node.js 18+ or compatible runtime
- pnpm (recommended) or npm
- Clone the repository:
git clone https://github.com/houndslight/Kyoku.git
cd Kyoku- Install dependencies:
pnpm install- Run the development server:
pnpm dev- Open http://localhost:3000 in your browser
pnpm build
pnpm start- Framework: Next.js 15
- UI Library: React 19
- Styling: Tailwind CSS v4
- Components: Radix UI
- Icons: Lucide React
- Typography: Hiragino Mincho Pro (with fallbacks)
- Language: TypeScript
Kyoku embraces Japanese minimalism with:
- Clean, uncluttered interface
- Elegant typography using Hiragino Mincho Pro
- Subtle color palette inspired by traditional Japanese aesthetics
- Focus on content over chrome
- Smooth, intentional animations
Kyoku can be installed as a Progressive Web App on both desktop and mobile devices for a native app-like experience.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is open source and available under the MIT License.
Zachary T.
houndslight.online
If you find this project useful, consider supporting via crypto:
Ethereum (ETH)
0xcFB691775016E229F040Ee4F3C418035d8Ec3401
Monero (XMR)
48PnUkPPDtBa12LXNzi8pEj2k61jDEhVkMZuZzabubjN9dF5m1eicveGjvnr1R7vNwhsRmb9HPYtSQYrjdmPFY2374yp1i8
- Inspired by minimalist design principles
- Built with modern web technologies
- UI components from Radix UI and shadcn/ui
Made with ❤️ by houndslight (Zachary T.) | 2025 til infinity