https://github.com/byteofmelon/openturntable
A (hopefully good) OSS music player. (WIP)
https://github.com/byteofmelon/openturntable
desktop-app desktop-application golang gplv3 linux macos music music-player nuxt3 wails-app windows
Last synced: 3 months ago
JSON representation
A (hopefully good) OSS music player. (WIP)
- Host: GitHub
- URL: https://github.com/byteofmelon/openturntable
- Owner: ByteOfMelon
- License: gpl-3.0
- Created: 2025-03-11T01:26:36.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-16T17:01:11.000Z (about 1 year ago)
- Last Synced: 2025-05-31T20:50:36.516Z (about 1 year ago)
- Topics: desktop-app, desktop-application, golang, gplv3, linux, macos, music, music-player, nuxt3, wails-app, windows
- Language: Go
- Homepage:
- Size: 737 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
A (hopefully good) OSS music player.
> [!WARNING]
> OpenTurntable is still incredibly early in development, and is not ready for
> production at this time.
> **Use at your own risk!**
## Features
### Current
- Supports .mp3, .flac, .wav, and .ogg playback
- Gathers metadata from files (title, artist, album art, etc)
- Volume control
- Library system to store a collection of music
- Shuffle, repeat/repeat one, previous/next
- Now playing tab that shows you more info about your currently playing song, alongside the next song in your queue
### Planned
- Allowing user to edit song metadata once imported (see issue [#9](https://github.com/TheRandomMelon/OpenTurntable/issues/9))
- Playlist system (see issue [#2](https://github.com/TheRandomMelon/OpenTurntable/issues/2))
- Last.fm scrobbling support (see issue [#4](https://github.com/TheRandomMelon/OpenTurntable/issues/4))
- EQ (equalizer) (see issue [#5](https://github.com/TheRandomMelon/OpenTurntable/issues/5))
## Current Stack
- [Wails](https://wails.io)
- [Nuxt 3](https://nuxt.com)
## Using the Source Code
### C Bindings
Some packages utilized in OpenTurntable require a C compiler such as GCC to be installed and in your environment variables for the app to work.
On Windows, download [MSYS2](https://www.msys2.org), follow the initial installation instructions, and then add `C:\msys64\ucrt64\bin` to your PATH (assuming default install location).
> [!NOTE]
> You also may or not need to run `go env -w CGO_ENABLED=1` to tell Go to enable CGO.
### Live Development
To run in live development mode, run `wails dev` in the project directory.
### Building
To build a redistributable, production mode package, use `wails build -tags "production"`.