Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ilesinge/shabda
Shabda is a semantic audio samples curator for livecoding software such as Estuary or Tidal Cycles
https://github.com/ilesinge/shabda
audio audio-samples flask freesound livecoding python tidalcycles
Last synced: 3 months ago
JSON representation
Shabda is a semantic audio samples curator for livecoding software such as Estuary or Tidal Cycles
- Host: GitHub
- URL: https://github.com/ilesinge/shabda
- Owner: ilesinge
- License: mit
- Created: 2019-08-13T19:23:12.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-20T16:35:02.000Z (9 months ago)
- Last Synced: 2024-08-25T00:47:14.191Z (4 months ago)
- Topics: audio, audio-samples, flask, freesound, livecoding, python, tidalcycles
- Language: Python
- Homepage: https://shabda.ndre.gr/
- Size: 408 KB
- Stars: 17
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Shabda
======
Shabda is a tool to fetch random samples from https://freesound.org/ based on given words or to generate Text-to-Speech samples for use in impro sessions on instruments such as Tidal Cycles, Estuary or Strudel.
[Shabda](https://en.wikipedia.org/wiki/Shabda) is the Sanskrit word for "speech sound". In Sanskrit grammar, the term refers to an utterance in the sense of linguistic performance.
Install
-------
- Install Python 3: https://www.python.org/
- Install pip: https://pypi.org/project/pip/
- Install ffmpeg: https://ffmpeg.org/ (e.g. Debian/Ubuntu: `apt install ffmpeg`)
- Install Shabda for standard usage: `pip install shabda`
or
- Install shabda for hacking:
- Install poetry: https://python-poetry.org/docs/#installation
- In Shabda repository, install dependencies: `poetry install`
Use (command line)
------------------
In order to download a sample pack, execute in the terminal `shabda --licenses `.
Any word can be a pack definition. If you want more than one sample, separate words by a comma: `blue,red`
You can define how many variations of a sample to assemble by adding a colon and a number.
e.g. `blue,red:3,yellow:2` will produce one 'blue' sample, three 'red' samples and two 'yellow' sample.
The optional `--licenses` parameter allows to fetch only samples that have the specified license. Multiple licenses can be allowed by repeating the `--licenses` argument. Possible licenses are `cc0` (Creative Commons Zero), `by` (Creative Commons Attribution), and `by-nc` (Creative Commons Attribution Non-Commercial).
Full example:
```
shabda spaghetti:2,monster:4 --licenses cc0 --licenses by
```
The first time you execute this command, it will ask you for a Freesound token, that you will be redirected to. You will need a Freesound account.
By default, samples will be downloaded in a `samples` directory under the current working directory. You can override this by adding a `config.ini` file to the `$HOME/.shabda/` directory, containing:
```ini
[shabda]
samples_path=/path/to/your/desired/samples/directory/
```
Use (web application)
---------------------
Launch the web application:
In debug mode:
```
FLASK_APP=shabda FLASK_DEBUG=1 flask run
```
In production:
```
gunicorn --workers=4 "shabda:create_app()" -b localhost:8000
```
Test
----
```
poetry run pytest
```
Notes
-----
With Estuary, Shabda makes use of this feature: https://github.com/dktr0/estuary/wiki#adding-sound-files-to-estuarywebdirt-on-the-fly
All command line examples must be preceded by `poetry run` if in hacking/development mode.
Roadmap
-----
See: https://github.com/users/ilesinge/projects/4