muzik-offline

A cross platform, local music player that is an offline(no streaming) version of muzik. This app allows you to listen to music that is stored on your local machine, that being music in mp3, wav, ogg and flac format.

Table of Contents

• muzik-offline
• Table of Contents
• I am a user/tester
• Usage
• I am a developer
  • Development Cycle
  • Building
• Node modules used
• Rust libraries used

I am a user/tester

1. Navigate to the releases tab and find the latest app release for your operating system.
2. Download it and install and enjoy the application
3. Please read the usage section for some extra information.
4. Also note that you can report bugs/issues or make feature requests

Usage

1. Some shortcuts include
   • SPACE - Pause/Play music
   • CTRL/CMD + SHIFT + F - Open/Close settings
   • CTRL/CMD + S - Focus on search bar
   • CTRL/CMD + I - Show song info
   • UP or DOWN - scroll song by song
   • LEFT or RIGHT - seek by fixed value
   • CTRL/CMD + P or ENTER - Play the selected song
   • CTRL/CMD + SHIFT + A - Add to playlist
   • CTRL/CMD + SHIFT + L - Play later
   • CTRL/CMD + SHIFT + N - Play Next

I am a developer

Development Cycle

1. Download the pre-requisites for tauri only by following the pre-requisites page for your operating system.
2. If you are on a linux based OS, run

sudo apt-get install libasound2-dev

3. Clone this repo or fork it and clone it.
4. run

cd muzik-offline/muzik-offline

5. run

npm install

6. This application uses discord rpc, so you will need a client id, otherwise the application won't run
7. To get a client id, setup a new application on discord developer portal and then place your client id in an .env file in the src-tauri directory
8. The env file should look like this:

DISCORD_CLIENT_ID=<Your client id goes here>

9. run

npm run tauri dev

10. You can encrypt your env file with:

openssl enc -aes-256-cbc -salt -pbkdf2 -in src-tauri/.env -out src-tauri/.env.enc -pass pass:{pass-key}

Building

1. Clone the releases branch. It is the most stable and "ready-to-go" branch
2. If you want to create a production build, run

npm run tauri build

3. If you want to create a debug production build(one where you have access to devtools), run

npm run tauri build -- --debug

Note

Please note that when you run npm run tauri dev, npm run tauri build or npm run tauri build -- --debug for the first time, it may take a lengthy amount of minutes to compile everything. However this only occurs just on your first run. In subsequent runs, it will be faster.

Node modules used

1. tauri-apps
2. dexie
3. framer motion
4. react and react-dom
5. react-router-dom
6. react viewport list
7. sass
8. zustand
9. react-loading-skeleton

Rust libraries used

1. tauri
2. serde
3. serde_json
4. id3
5. lofty
6. tokio
7. base64
8. image
9. kira
10. rand
11. rayon
12. sled
13. dirs
14. discord-rich-presence
15. dotenv
16. souvlaki
17. warp
18. tauri-plugin-shell
19. tauri-plugin-notification
20. tauri-plugin-dialog
21. tauri-plugin-http
22. tauri-plugin-os
23. printpdf
24. tabled
25. walkdir
26. futures