https://github.com/marcinorlowski/mp3voicestamp
Athletes' companion: add synthetized voice overlay with various info and on-going timer to your audio files
https://github.com/marcinorlowski/mp3voicestamp
audio audio-files mp3 practice swimming voice-synthesis
Last synced: 7 months ago
JSON representation
Athletes' companion: add synthetized voice overlay with various info and on-going timer to your audio files
- Host: GitHub
- URL: https://github.com/marcinorlowski/mp3voicestamp
- Owner: MarcinOrlowski
- Created: 2018-10-03T09:41:26.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-09-30T10:18:47.000Z (about 5 years ago)
- Last Synced: 2025-02-12T22:44:13.282Z (8 months ago)
- Topics: audio, audio-files, mp3, practice, swimming, voice-synthesis
- Language: Python
- Homepage:
- Size: 8.29 MB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
Awesome Lists containing this project
README
Athletes' companion: adds synthetized voice overlay with various info and on-going timer to your audio files
[](https://www.codefactor.io/repository/github/marcinorlowski/mp3voicestamp)
[](https://www.codacy.com/app/MarcinOrlowski/Mp3VoiceStamp?utm_source=github.com&utm_medium=referral&utm_content=MarcinOrlowski/Mp3VoiceStamp&utm_campaign=Badge_Grade)
[](https://houndci.com)
## Table of contents ##
* [Introduction](#introduction)
* [Demo MP3 file](#sample)
* [Features](#features)
* [Configuration and usage](docs/USAGE.md)
* [Requirements and installation](docs/INSTALL.md)
* [Bugs reports and contributions](docs/CONTRIBUTING.md)
* [Credits and license](#credits-and-license)
* [What's new?](docs/CHANGES.md)
## Introduction ##
Whenever you do any physical activities, there's high chance you bring your music with you. So do I, but I do swim
a lot and in my case, my audio player UI is pretty non existent. It has just 5 control buttons and that's it.
You cannot even tell what track you selected, unless you recognize it. I personally prefer to swim with
so-called DJ mixes - 1 hour long (or more) mixed tracks of various artists just to keep music go without gaps
between tracks. Having no UI in audio player brings at least two problems:
* it is sometimes hard to tell what mix you just started to listen to (they often need some time to spin up or
feature the same opening intro jingle),
* as there's no display to peek, you cannot easily tell how much time passed so you cannot tell how long you are
swimming already.
The aim of this tool is to address these issues. The idea behind is quite simple: you take MP3 track of your choice
and add synthetized voice overlay with required information. The voice announces the track (by title, filename
or ID3 tags of your choice), then can keep speaking time passed at given intervals (each 5 minutes by default).
> 
> _while swimming is that while title announcement feature is just "useful thing" and nothing more, then the
> "time ticks" works more like your personal trainer and for me it adds some motivational bits to my swimming which
> is completely unexpected. It seems like it puts kind of subtle pressure so I actually swim more, trying to hear
> next time "milestone" announced. It's like some sort of gamification in swimming in practice... Interesting :)_
## Sample ##
 One audio file tells more that thousands words, so why not try the example MP3 file now?
Hear for yourself what this tool does in practice!
* [Listen on SoundCloud](https://soundcloud.com/marcinorlowski/mp3voicestamp-tool-demo)
* [Download sample MP3 file](sample/mp3voicestamp-demo.mp3) (6 MiB size)
----
And if you are interested in music, sample is based on Olga Misty's DJ mix "Ocean Planet 086 Part 2" which can be found on
[MixCloud](https://www.mixcloud.com/olgamisty/olga-misty-ocean-planet-086-part-2-aug-06-2018-on-proton-radio/) and
[SoundCloud](https://soundcloud.com/olga_misty/olga-misty-ocean-planet-086-part-2-aug-06-2018-on-proton-radio).
## Features ##
* Automatic voice volume adjustment based on music file volume
* Supports batch processing of multiple files
* Features dry-run mode for quick tests
* Highly customizable
* Minimal runtime dependencies
* Works on Linux, Mac OS and Windows
* Free
## Credits and license ##
* Written and copyrighted ©2018 by Marcin Orlowski
* MP3AudioStamp is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)
* Icons used in logo taken from free [Icons8 Olympics Sports Icon Pack](https://icons8.com/free-icons/olympics_sports)