The AROS Archives @ aros-exec.org

(anonymous IP: 18.218.38.67,352)

Home

Recent

Stats

Search

Submit

Uploads

Mirrors

Contact

Info

Disclaimer

Config

Admin

Audio (96)

Datatype (15)

Demo (50)

Development (247)

Document (62)

Driver (19)

Emulation (62)

Game (529)

Graphics (224)

Library (22)

Network (62)

Office (21)

Utility (250)

Video (18)

Total files: 1677

Full index file
Recent index file

Part of aros exec

Consider these values before uploading:

Maximum file size : 650Mb
File upload timeout : 60 minutes

For each 12 hour period you must not :
- Upload more than 20 files.
- Upload more than 650Mb.

Important! Please name your file by following this naming convention: (package name).(aros platform).(archive format)
The (aros platform) would most likely be the following: i386, ppc, sparc, arm, or alpha

If you need help then please go here. Also read the site disclaimer before uploading.

(*) - These fields are required. If you don't fill them in you'll be very frustrated after uploading your file and it gets deleted.

Name *

Name of your upload

Description *

Version

Author *

Submitter *

Email *

Hide from view.

URL

Category

Filename *

Replaces

Requirements

License

Distribute

What is this?

Passphrase

The passphrase is not prefilled automatically! What is this?

Readme text *

kMusicPlayer

### kMusicPlayer is a visual music player built with C and Raylib. It provides a simple visual interface for playing your favorite music tracks.
### The target of this project is developing a software to be able to enjoy music also in a visual way.
#

<img src="images/demo.gif" alt="Main Interface of kMusicPlayer" width="400">
 
 kMusicPlayer Interface

# Features

- **Music Playback**: Play your favorite tracks with ease. Supports `.mp3` and `.wav` formats.
- **Waveform Visualization**: Visualize your music with waveform rendering.
- **Threaded Music Loading**: Load your music fast with threaded loading.
- **Simple Controls**: Control playback with simple keyboard shortcuts using RayGUI.

# How to Use

## 1. **Installation**:
- Download the latest release from the [Releases](https://github.com/notkatsuu/kMusicPlayer/releases) page.
- Extract the contents of the archive to a folder of your choice.
- Run the executable file to start the application.

The program will ask you to select a folder containing your music files. Select a folder and click "Open".

It will load all music files in the selected and will store their waveforms in the "cache/waveforms" folder.

## 2. **Controls**:
### All the controls available in the application are implemented with RayGUI. The following are the available controls:
- **Play/Pause**: Click the play/pause button or press `Space` to play or pause the current track.
- **Next Track**: Click the next track button or press `P` to skip to the next track.
- **Previous Track**: Click the previous track button to go back to the previous track.
- **Volume Control**: Use the volume slider to adjust the volume of the current track.
- **Seek Track**: Use the seek slider or Right/Left Arrows to seek to a specific position in the current track.
- **Info Button**: Click the info button to view information about the current track.
- **Theme Button**: Click the theme button to switch between light and dark themes.

## 3. **View Waveform**: 
#### The waveform of the current track is displayed in the main window. It shows the amplitude of the audio signal over time. The waveform is loaded at the start of the track and is displayed in real-time as the track plays.
#### All Waveforms are stored in the "cache/waveforms" folder. If you want to delete them, you can do it manually. The program will generate them again when you play the track.
![Waveform Visualization](images/waveform.png "Waveform Visualization")
Frank Sinatra's Come Fly With Me

## 4. **Themes**:
#### The application uses RayGui and supports a variety of themes to customize the look and feel of the interface. 
#### You can switch between themes by clicking the theme button in the top-right corner of the window.

# Building from Source

### kMusicPlayer uses CMake for its build system. To build from source, follow these steps:

### 1. Clone the repository: `git clone https://github.com/your_username/kMusicPlayer.git`
### 2. Navigate to the project directory: `cd kMusicPlayer`
### 3. Create a build directory and navigate to it: `mkdir build && cd build`
### 4. Run CMake to generate the build files: `cmake ..`
### 5. Build the project: `cmake --build .`

# License

### This project is licensed under the [MIT](https://choosealicense.com/licenses/mit/) License. See the `LICENSE` file for details.

Comments

Send comments/suggestions etc to the administrator here. This will not be a part of the final readme.

Upload to aminet
Aminet Filename	(Leave blank to use the original filename)
Aminet Category *	Category list
Aminet Version	Example: 3.23.1
Aminet Architecture	Info here

The upload will start and complete before loading the confirmation page. So show patience while uploading.