X-Git-Url: https://git.immae.eu/?p=perso%2FImmae%2FProjets%2FPython%2FMusicSampler.git;a=blobdiff_plain;f=documentation_en.md;h=17b8c87dd1d12fc6a21fd50b38a94f16131ea19a;hp=ac12909142ff535285ba2ff401ac3550016fae02;hb=HEAD;hpb=b798117bb79038ae7495ea4fdb5254d15c7e4b63 diff --git a/documentation_en.md b/documentation_en.md index ac12909..2f570e1 100644 --- a/documentation_en.md +++ b/documentation_en.md @@ -9,6 +9,8 @@ set of actions to run. ## Dependencies and installation +(See next section for Windows installation) + - You need ffmpeg installed. For that, you can use package `libav-tools` (debian): sudo apt-get install libav-tools @@ -46,6 +48,31 @@ To compile Kivy with the SDL2 library, you need some packages: cf [Installation Kivy](https://kivy.org/docs/installation/installation-linux.html) +## Windows installation + +Following processed worked to install music sampler in a Windows +machine: + +- [Install python 3.9.\* (take 64bit version!)](https://www.python.org/downloads/windows) +- In a command shell (`cmd.exe`), run: + + pip install music_sampler + pip install docutils pygments pypiwin32 PySDL2 kivy.deps.sdl2 kivy.deps.glew + +- [Install ffmpeg (64bit, static)](https://ffmpeg.zeranoe.com/builds/) + and put the content of folder `bin` in the same folder as music and configs. +- [Download Ubuntu font](https://www.1001fonts.com/ubuntu-font.html) + and install Ubuntu-R and Ubuntu-B (Regular and Bold) *for all users* (right clic on the font) +- [Download Symbola font](https://fontlibrary.org/en/font/symbola) + and install it *for all users* (right clic on the font) +- Write a `run.bat` file with: + + :::bash + @echo off + music_sampler + +- Run this `run.bat` when you need it. + ## Compiled version A compiled version can be created with `pyinstaller`: @@ -130,6 +157,7 @@ in case of problem with the standard configuration: (default 2). * `--device DEVICE` : select another sound device. * `--list-devices` : list available sound devices. + * `--load-all-musics` : load all the music when starting (default True) * `-- ARGS` : arguments for Kivy library. ## Configure keys @@ -321,6 +349,8 @@ Pauses "music1.mp3" for 10 seconds and reruns it afterward, seeking to 5 seconds later. #### List of all the actions: +- `comment`: does nothing, but shows a comment in the action windows + * `message: "some text"` the message to show - `play` : start a music. Music Sampler only runs a music once (if you want to have it playing several time concurrently, duplicate it or make symbolic link). Parameters: @@ -409,6 +439,9 @@ actions. * `command: my_command` : Gives the command to run. * `wait: true/false` (optional, default false) if true, waits for the command to finish (this wait is not interruptible by interrupt_wait) +- `load_music/unload_music` : load/unload a music from memory. Useful + with `load_all_musics` option only + * `music: "music.mp3" the music to load/unload ### `aliases` : define aliases