https://github.com/alvarorichard/duckwave
Straightforward audio player written in C, designed for simplicity and ease of use. It supports playing multiple audio formats
https://github.com/alvarorichard/duckwave
audio audio-player c command-line flac mp3 music-player opensource simple terminal
Last synced: 4 months ago
JSON representation
Straightforward audio player written in C, designed for simplicity and ease of use. It supports playing multiple audio formats
- Host: GitHub
- URL: https://github.com/alvarorichard/duckwave
- Owner: alvarorichard
- License: mit
- Created: 2023-10-01T01:42:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-22T18:24:26.000Z (about 1 year ago)
- Last Synced: 2025-04-22T19:41:27.286Z (about 1 year ago)
- Topics: audio, audio-player, c, command-line, flac, mp3, music-player, opensource, simple, terminal
- Language: C
- Homepage:
- Size: 30.6 MB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
English |
Рortuguês
[](https://app.codacy.com/gh/alvarorichard/DuckWave/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://github.com/alvarorichard/DuckWave/actions)
DUCKWAVE is a straightforward audio player written in C, designed for simplicity and ease of use. It supports playing multiple audio formats and offers basic controls such as play, pause, and stop. The project is built with minimal dependencies and is focused on providing a user-friendly experience for playing audio files from the terminal.
* Music "Phat Sketch" Kevin MacLeod (incompetech.com)
Licensed under Creative Commons: By Attribution 4.0 License [link](http://creativecommons.org/licenses/by/4.0/)
https://github.com/alvarorichard/DuckWave/assets/88117897/80ba79bc-8d38-40e7-aa3b-b951fbaa9cf2
## Supported Audio Formats
- MP3
- WAV
- FLAC
## Installation
#### Prerequisites
Ensure you have the following libraries installed:
- `xmake` build system(optional)
- `ncurses` library
- `mold` linker
### Compiling the Code
```bash
xmake
```
### Compiling the Code with the Script
```bash
chmod +x install.sh
```
Run the script:
```bash
./install.sh
```
This will create an executable called mp3player in your current directory.
## Usage
1. Add your mp3 file to the project directory.
2. In the main() function of main.c, replace "add you music here .mp3" with your mp3 file name.
3. Compile the code.
4. Run the executable:
```C
./mp3player your music.mp3
```
> [!IMPORTANT]
> Please note that this project is still under development and may be subject to changes and improvements.
## Contributing
Contributions to this project are welcome. Please follow these steps to contribute:
1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes.
4. Push to the branch.
5. Submit a pull request.
