Cloudie

Yet another Open Source Kawaii Soundcloud Client.

Features

Warning

This project is still under heavy development, and many features are not yet implemented or may not work as expected.

• Web-like experience - Fully functional desktop client
• Blazing Fast - Directly interact with the API, no web scraping involved
• Downloader - Download tracks or playlists and embed covers
• Customizable - Multilingual support and theme options
• DJ Support - Use Soundcloud functionality without a Paid DJ software Plan (WIP)
• Scrobbling support - Log track playtime to last.fm or similar services (WIP)

Logging in

Tip

Login is required for this application to be fully functional.

This app does not use the Soundcloud API to perform token update, which reduces the possibility triggering any captcha or rate limiting.

Setting up the Project

1. Clone the repository.
2. Install dependencies: pnpm install
3. Run the project: pnpm tauri dev
4. Build the project locally: pnpm tauri build

Debugging Rust

For VSCode users, you simply choose Tauri Development Debug in the debug tab and run.

For Zed users, you have to run the ui:dev task then use the Debugger to start the debugging session.

Contributing

Database Schema

1. Modify the database schema in src/systems/db/schema.ts
2. Run pnpm drizzle-kit generate if a table upgrade is needed.
3. Modify the migrations in src-tauri/src/lib.rs to include the new table.
4. (Optional) Run the program using pnpm tauri dev to apply the migrations on-runtime.

Report Issues / Submit Feature Requests: Issues

Pull Requests: Pull Requests