Add icons refactor repo structure
This commit is contained in:
parent
1fec61140c
commit
b719d8cf96
24 changed files with 317 additions and 594 deletions
78
README.md
78
README.md
|
|
@ -1,88 +1,36 @@
|
|||
# Music Generator GUI
|
||||
# Aceradio
|
||||
|
||||
A Qt-based graphical user interface for generating music using acestep.cpp.
|
||||
|
||||
## Features
|
||||
|
||||
- **Song List Management**: Add, edit, and remove songs with captions and optional lyrics
|
||||
- **Playback Controls**: Play, skip, and shuffle functionality
|
||||
- **Settings Tab**: Customize the JSON template for AceStep generation parameters
|
||||
- **Progress Tracking**: Visual progress bar during music generation
|
||||
- **Seamless Playback**: Automatically generates and plays the next song when current one finishes
|
||||
A C++ Qt graphical user interface for generating music using acestep.cpp.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Qt 5 or Qt 6 (with Core, Gui, Widgets, and Multimedia modules)
|
||||
- Qt 6 Core, Gui, Widgets, and Multimedia
|
||||
- CMake 3.14+
|
||||
- acestep.cpp properly built with models downloaded
|
||||
- acestep.cpp (bring your own binaries)
|
||||
|
||||
## Building
|
||||
|
||||
### Build acestep.cpp first:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/ServeurpersoCom/acestep.cpp.git
|
||||
cd acestep.cpp
|
||||
git submodule update --init
|
||||
mkdir build && cd build
|
||||
cmake .. -DGGML_BLAS=ON # or other backend options
|
||||
cmake --build . --config Release -j$(nproc)
|
||||
cmake .. -DGGML_VULKAN=ON # or other backend
|
||||
make -j$(nproc)
|
||||
./models.sh # Download models (requires ~7.7 GB free space)
|
||||
```
|
||||
|
||||
### Build the GUI application:
|
||||
### Build the GUI:
|
||||
|
||||
```bash
|
||||
cd ..
|
||||
git clone git@github.com:IMbackK/aceradio.git
|
||||
cd aceradio
|
||||
mkdir build && cd build
|
||||
cmake ..
|
||||
cmake --build . --config Release -j$(nproc)
|
||||
make -j$(nproc)
|
||||
```
|
||||
|
||||
## Usage
|
||||
### Build the GUI:
|
||||
|
||||
1. **Add Songs**: Click "Add Song" to create new song entries with captions and optional lyrics
|
||||
2. **Edit Songs**: Select a song and click "Edit Song" to modify it
|
||||
3. **Remove Songs**: Select a song and click "Remove Song" to delete it
|
||||
4. **Play Music**: Click "Play" to start generating and playing music from the selected song or first song in the list
|
||||
5. **Skip Songs**: Click "Skip" to move to the next song immediately
|
||||
6. **Shuffle Mode**: Toggle "Shuffle" to play songs in random order
|
||||
7. **Settings**: Click "Settings" in the menu bar to edit the JSON template for generation parameters
|
||||
|
||||
## Settings (JSON Template)
|
||||
|
||||
The JSON template allows you to customize AceStep generation parameters:
|
||||
|
||||
```json
|
||||
{
|
||||
"inference_steps": 8,
|
||||
"shift": 3.0,
|
||||
"vocal_language": "en",
|
||||
"lm_temperature": 0.85,
|
||||
"lm_cfg_scale": 2.0,
|
||||
"lm_top_p": 0.9
|
||||
}
|
||||
```
|
||||
|
||||
Available fields:
|
||||
- `caption` (required, will be overridden by song entry)
|
||||
- `lyrics` (optional, can be empty to let LLM generate)
|
||||
- `instrumental` (boolean)
|
||||
- `bpm` (integer)
|
||||
- `duration` (float in seconds)
|
||||
- `keyscale` (string like "C major")
|
||||
- `timesignature` (string like "4/4")
|
||||
- `vocal_language` (string like "en", "fr", etc.)
|
||||
- `seed` (integer for reproducibility)
|
||||
- `lm_temperature`, `lm_cfg_scale`, `lm_top_p`, `lm_top_k` (LM generation parameters)
|
||||
- `lm_negative_prompt` (string)
|
||||
- `audio_codes` (string, for advanced users)
|
||||
- `inference_steps` (integer)
|
||||
- `guidance_scale` (float)
|
||||
- `shift` (float)
|
||||
|
||||
## Notes
|
||||
|
||||
- The first time you generate a song, it may take several minutes as the models load into memory
|
||||
- Generated WAV files are created in your system's temporary directory and played immediately
|
||||
- Shuffle mode uses simple random selection without replacement within a playback session
|
||||
- Skip button works even during generation - it will wait for current generation to finish then play next song
|
||||
Go to settings->Ace Step->Model Paths and add the paths to the acestep.cpp binaries the models.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue