OiDuark

Warning
The future of this project:
It has been a long time maintaining this project. Currently I'm going to plan the next version for it.

In the next version, OiDuark will never be developed in Java. Instead, it will be written in Golang. Golang is a quite beautiful programming language that may help this project become more concise and effective to run. Comparing to Java, Golang has been proved having a better performance, and we can directly compile Golang program into binary code so it doesn't need to be wrapped as an archive like JAR and run on any virtual machine like JVM.

Moreover, the Wails framework will give us an out-of-the-box solution to develop a frontend-backend separated application. This will help us to write tests or maintain project in a more efficient way.

In any time you want to enjoy musics or songs with specific styles, you won't need to add them to a new play list anymore. Just use Tag Filter 😍.

Architecture 🔧

Description 📋

This is a music player desktop application developed by JavaFX.

With this application, you can enjoy the downloaded musics or songs anytime. You won't need to manually add them into a new play list anymore. Just use the tag filter.

Features 🤩

• Editing musics/songs title, author, tags, ...etc
• Customizing tags name and color
• Adding your favorite musics/songs
• Searching audio by keywords and tags
• Playing a queue of musics/songs
• Will not litter your user home(either ~ in linux or C:/Users/${your username} in windows).
• Choose your own media storage and userdata storage path.

Requirements 💻

• Windows 10 / Windows 11 / Linux
• Java 11+ (Optional)

Usage 🧭

Please check if your environment satisfies the requirements.

Note that if you download the binary release from the github releases page, it includes the java runtime, which is the supported version. So you won't need to install java runtime on your environment.

Generic

Download the latest released tar.gz(for Linux) /zip(for Windows) file. Extract the files and use the commands below to launch OiDuark:

cd oiduark-0.0.3-SNAPSHOT/bin
./java -jar oiduark.jar

Note: You may need to specify the GTK version to support input methods other than English if you're using Linux with GTK2+ installed. Here's an example:

./java -Djdk.gtk.version=2 -jar oiduark.jar

Linux

Download the latest released tar.gz file. And then extract them by executing the command:

tar -xvf oiduark-0.0.3-SNAPSHOT.tar.gz

And use the command below to install OiDuark:

sh oiduark-0.0.3-SNAPSHOT/install.sh

It will create a desktop application so you can find it in the application menu.

Windows

The instruction is waiting for update. Use Generic instruction instead.

TO-DO 🎯

• create userdata inside user's local appdata
• upgrade to java 17
• lyrics display
• browsing musics and songs & downloading
• more customizable appearance