Skip to content

Commit 3bb1bea

Browse files
authored
Update README.md
1 parent cdeec3a commit 3bb1bea

1 file changed

Lines changed: 1 addition & 53 deletions

File tree

README.md

Lines changed: 1 addition & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -56,62 +56,10 @@ And then upload the results to the [visualizer](https://mutilatedperipherals.git
5656

5757
<img width="100%" alt="image" src="https://github.com/user-attachments/assets/22f55e81-60d2-4549-bca7-bc75b09b01ff" />
5858

59-
## Local development
60-
61-
### Install deps
62-
63-
```bash
64-
# 1. Install python requirements
65-
python - m venv venv
66-
source venv/bin/activate
67-
pip install -r requirements.txt
68-
69-
# 2. Install ffmpeg. This is how to do it on Ubuntu:
70-
sudo apt-get update
71-
apt-get install ffmpeg
72-
```
73-
74-
### Specify the input files & run the code
75-
76-
1. Create a `csv` file to pass as input to the `pipeline.py` file.
77-
78-
The only mandatory column is `src`, with the file paths of the songs to analyze. Youtube URLs are also supported on a
79-
best-effort basis (uses `yt-dlp` to download the audio).
80-
81-
Example:
82-
83-
```csv
84-
src
85-
/home/linomp/Downloads/CURETAJE - Arutam.mp3
86-
https://youtu.be/dQw4w9WgXcQ?si=J-UoAhM54KQGR6eW
87-
```
88-
89-
<details>
90-
<summary>Additional fields (advanced)</summary>
91-
Other fields are supported for debugging & development, with the most important one being `step_size_in_seconds`, which determines the size of the segments on which the song is split & analized (default value: 0.15s).
92-
93-
In `pipeline.py` you can see all the configurable fields. If left blank or unspecified, defaults will be used.
94-
95-
Here is an example specifying an extra field:
96-
97-
```csv
98-
src,step_size_in_seconds
99-
/home/linomp/Downloads/CURETAJE - Arutam.mp3
100-
./tmp/DER WEG EINER FREIHEIT - Ruhe (Tobias Schuler Drum Playthrough).mp3,0.1
101-
./tmp/Deceso.mp3,0.18
102-
```
103-
</details>
104-
105-
2. Point to the csv file & run it
106-
```bash
107-
pipeline.py ./songs.csv
108-
```
109-
11059
## News
11160
The Blast Beat Detector was presented in the [6th meetup](https://pythonleiden.nl/meeting-2025-11-13.html) of the Python Leiden user group 🇳🇱! --> [**Slides here**](https://docs.google.com/presentation/d/1iJMSQG28AYHlkn9QP00kx2yHenX1uifUPS29b-Rtshc/edit?usp=sharing)
11261

113-
<!-- <img width="30%" alt="image-4" src="https://github.com/user-attachments/assets/5088f77c-f052-46a4-b2e5-d5ebf886e6e6" /> -->
114-
<img width="50%" alt="image-3" src="https://github.com/user-attachments/assets/5604da35-c72f-4f3c-8673-e84624059460" />
62+
<img width="70%" alt="image-3" src="https://github.com/user-attachments/assets/5604da35-c72f-4f3c-8673-e84624059460" />
11563

11664

11765

0 commit comments

Comments
 (0)