pythonMuzyka - beatbox

Repozytorium pythonMuzyka zawiera następujące pliki i foldery:

beatbox.py - główna aplikacja; skrypt tworzący piosenkę, która została podana jako argument,
create_song.py - moduł z funkcją create_song do tworzenia piosenki ze ścieżek,
create_track.py - moduł z funkcją create_track do tworzenia ścieżki z sampli, nutek i instrumentów,
- merge_sounds.py - moduł z funkcją merge_sounds do złączania dwóch dźwiękóW stosując przesunięcie dźwięków w ścieżce,
sounds.py - moduł z definicją dźwięków w postaci funkcji:
- sound_sin - funkcja tworząca falę sinusoidalną,
- sound_sawtooth - funkcja tworząca falę trójkątną (piła),
- sound_rectangle - funkcja tworząca falę prostokątną,
notes.txt - plik tekstowy ze słownikiem nutek,
sample_song - folder z piosenką stworzoną z sampli,
db_gt_main_opening - folder z piosenką z głównym motywem openingu anime Dragonball GT,
last_christmas - folder z piosenką "Last Christmas",
songs - folder z wygenerowanymi piosenkami.

Ponadto każdy z folderów z piosenkami składa się z:

defs.txt - plik tekstowy ze słownikiem opisującym konfigurację utworu - zawiera tylko argument bpm,
song.txt - plik tekstowy określający kolejność odgrywanych ścieżek,
trackAB.txt - pliki tekstowe określające kolejność odgrywania sampli, nutek i instrumentów, gdzie AB to 2 cyfry; jeden wiersz jest odtwarzany na raz. Przykłady zapisu:
- 01 - odwołanie do sampla 01,
- A-4 - odwołanie do nutki o częstotliwości A-4,
- 01:A-4 - odwołanie do instrumentu 01 o częstotliwości A-4,
sampleXY.wav - pliki dźwiękowe, gdzie XY to 2 cyfry,
sampleXY.txt - pliki tekstowe określające definicję instrumentu w postaci kodu pythonowego, który powinien zawierać:
- global instrument - w pierwszej linijce określenie zmiennej instrument jako zmiennej globalnej,
- f - częstotliwość dźwięku,
- t - czas trwania dźwięku; trzeba pamietać o uwzględnieniu bpm,
- instrument - określenie użytego dźwięku wraz z przekształceniem go do macierzy wymiaru n x 2

Działanie programu

Program uruchamia się z folderu z programem (katalog bieżący) przy użyciu komendy:

./beatbox.py utworX/

lub

./beatbox.py utworX

gdzie utworX to nazwa katalogu z piosenką lub nazwa pliku w formacie *.zip.

W przypadku zwykłego folderu piosenka zostanie utworzona w katalogu bieżącym, zaś w przypadku archiwum w folderze tmp z plikami tymczasowymi.