diff --git a/flacsounds/stream.flac b/flacsounds/stream.flac deleted file mode 100644 index 2bb7697..0000000 Binary files a/flacsounds/stream.flac and /dev/null differ diff --git a/flacsounds/thunderstorm.flac b/flacsounds/thunderstorm.flac deleted file mode 100644 index 6b98ac8..0000000 Binary files a/flacsounds/thunderstorm.flac and /dev/null differ diff --git a/readme.md b/readme.md index d7f9d8c..f2d0269 100644 --- a/readme.md +++ b/readme.md @@ -1,24 +1,47 @@ # Ambientsounds -Curses based ambient sound player inspired by Noizio, A Soft Murmur, etc... +Curses based ambient sound player inspired by Noizio, A Soft Murmur, +etc... ## Dependencies The program depends on : -- python2 -- pygame to play the tracks -- mutagen to read the ogg vorbis tags +- [python 2](https://www.python.org/) +- [pygame](http://www.pygame.org/news.html) to play the tracks +- [mutagen](https://bitbucket.org/lazka/mutagen) to read the ogg vorbis tags ## Manual -- Up/Down to change select the master Volume or a track -- Left/Right to change the volume of the selected track -- q to quit +- `Up`/`Down` to change select the master Volume or a track +- `Left`/`Right` to change the volume of the selected track +- `q` to quit ## Sounds -The original sound files are listed below. They have been edited so that they can be looped seamlessly. The lossless edited versions are in the flacsounds folder, the lossy versions are in the sounds folder. The flacsounds folder is not needed by the program. +The original sound files are listed below. -- [Stream by mystiscool](http://www.freesound.org/people/mystiscool/sounds/7138/) -- [Thunderstorm by RHumphries](http://www.freesound.org/people/RHumphries/sounds/2523/) +- [Stream by mystiscool](http://www.freesound.org/people/mystiscool/sounds/7138/) (CC BY) +- [Thunderstorm by RHumphries](http://www.freesound.org/people/RHumphries/sounds/2523/) (CC BY) +- [Fireplace by inchadney](http://www.freesound.org/people/inchadney/sounds/132534/) (CC0) + +To add new sounds, you just need to create an ogg file of a few +minutes (preferably less than 5) that loops seamlessly, set the title +tag correctly, and put it in the `sounds` folder. Creating a seamless +loop is pretty easy with natural sounds, I personally use +[audacity](http://audacity.sourceforge.net/), with +[this method](http://manual.audacityteam.org/o/man/tutorial_looping.html) +to extract a segment that loops without clicking, and if needed, +[this one](http://www.wearytaffer.com/tutorials/tut_loops.html) to +fade the beginning and the end of the track. You can also modify the +tags when you export an ogg file with audacity. + +If you want me to add your sound to the program, you can make a pull +request or open an issue. This program is a free software, and will +only contain free sounds, with licenses such as CC0, CC BY, CC BY-SA +(and not CC BY-NC or CC BY-ND). + +## TODO + +- Add new sounds +- Save and load presets diff --git a/sounds/fireplace.ogg b/sounds/fireplace.ogg new file mode 100644 index 0000000..a410e5b Binary files /dev/null and b/sounds/fireplace.ogg differ