Skip to content
chauyinnPublic

About

๐ŸŽฎ๐ŸŽต Unofficial cross-platform Khinsider game soundtrack downloader built with Tauri 2, Rust & React.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

KhinFetch logo

KhinFetch

An unofficial, cross-platform desktop download manager for Khinsider game soundtracks.

Latest Release CI Status Platforms License: GPL-3.0-or-later

English ยท ็ฎ€ไฝ“ไธญๆ–‡


Note

This project was generated with AI assistance.

Important

Disclaimer: KhinFetch is an independent, unofficial client. It is not affiliated with, endorsed by, or maintained by Khinsider. The project does not grant any rights to music, artwork, metadata, or other third-party content. You are responsible for ensuring that your use and downloads are lawful and comply with the applicable website terms.

โœจ Features

  • ๐Ÿ” Smart Search & URL Parsing: Search Khinsider albums directly by keyword or parse album/playlist URLs on the fly.
  • ๐Ÿ“Š Rich Metadata Preview: Inspect release year, catalog number, track list, duration, audio formats, and file sizes before downloading.
  • ๐ŸŽง In-App Audio Preview: Listen to online MP3 sample previews directly within the app before queuing.
  • ๐ŸŽต Best Quality Priority: Automatically select the highest quality format available (e.g. Lossless FLAC) with graceful lossy fallback and clear mixed-quality indicators.
  • ๐Ÿ“ฆ Batch Links Import: Queue multiple album and playlist URLs concurrently.
  • ๐Ÿ–ผ๏ธ Album Artwork Archiving: Save original high-resolution album cover art alongside downloaded audio tracks.
  • โšก Persistent Queue Management: SQLite-backed download engine with pause, resume, retry, cancel, and seamless interrupted download recovery.
  • โš™๏ธ Flexible Customization: Fine-tune concurrent downloads, quality preferences, file integrity checks, logging levels, bilingual interface, and system-adaptive themes.

๐Ÿ“ธ Screenshots

Search

KhinFetch search interface

Download queue

KhinFetch download queue

๐Ÿš€ Installation & Releases

KhinFetch provides prebuilt packages for Windows, macOS, and Linux on the GitHub Releases page:

  • Windows: Standard installer (.exe) and portable standalone archive (.zip, extract and run).
  • macOS / Linux: System-specific distribution packages.

Tip

The portable version stores settings, the SQLite database, and logs in the current user's standard application data directory.

๐Ÿ› ๏ธ Development

Prerequisites

Getting Started

# Install frontend dependencies
pnpm install

# Run locally in development mode
pnpm tauri dev

Code Quality & Validation

Please run and pass all validation checks before submitting a pull request:

# Frontend linting and typechecking/build
pnpm lint
pnpm build

# Frontend state management regression tests
pnpm test

# Rust formatting, Clippy checks, and unit tests
cargo fmt --manifest-path src-tauri/Cargo.toml --all -- --check
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets --locked -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml --locked

Build Production Desktop Application

pnpm tauri build

Unsigned local bundles will be generated under src-tauri/target/release/bundle/.

๐Ÿ“ Project Structure

khinfetch/
โ”œโ”€โ”€ src/                    # React 19 + TypeScript frontend
โ”‚   โ”œโ”€โ”€ api/client.ts       # Unified communication boundary for Tauri backend calls
โ”‚   โ”œโ”€โ”€ api/generated/      # TypeScript types mirrored from Rust DTOs
โ”‚   โ”œโ”€โ”€ assets/             # Frontend icons and static assets
โ”‚   โ””โ”€โ”€ i18n/               # English and Simplified Chinese localizations
โ”œโ”€โ”€ src-tauri/              # Rust Tauri 2 backend core
โ”‚   โ”œโ”€โ”€ src/                # Downloader, parser, SQLite persistence, and system logic
โ”‚   โ”œโ”€โ”€ migrations/         # SQLite database schema migrations
โ”‚   โ””โ”€โ”€ icons/              # Platform bundle icons
โ”œโ”€โ”€ docs/images/            # Documentation screenshots
โ””โ”€โ”€ .github/workflows/      # CI build/test and release automation

๐Ÿค Contributing

Issues and pull requests are welcome. Keep changes focused, preserve the unofficial-client positioning, and run the validation commands above before submitting a pull request.

๐Ÿ’– Acknowledgements

  • Khinsider provides the website data consumed by the application.
  • The implementation was inspired by the open-source KhinsiderDownloader project.

๐Ÿ“„ License

Copyright (C) 2026 KhinFetch contributors.

Unless stated otherwise, the original KhinFetch source code and assets are licensed under the GNU General Public License, version 3, or (at your option) any later version (GPL-3.0-or-later). See LICENSE for details.

Third-party dependencies and content obtained from external services remain subject to their own licenses, copyrights, and terms.

About

๐ŸŽฎ๐ŸŽต Unofficial cross-platform Khinsider game soundtrack downloader built with Tauri 2, Rust & React.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages