Audipomarks NPM

Audipo Marks Manager

npm

audipomarks is an Audipo player marks manager, that allows you to:

split the all-marks file exported by the Audipo player into smaller chunks and distribute them among the directories they refer to;
recursively join multiple directory-level marks files into the all-marks one, that you can then import back into Audipo;
generate marks automatically using FFmpeg silencedetect filter.

Usage

Install:

$ npm i -g audipomarks

Split one big audipomark-file by media directories:

audipomarks split --root=MyMedia exported.audipomark

Join audipomark-files from media directories into one global.audiopomark file:

audipomarks join /path/to/media/

Generate marks:

audipomarks mark -r /path/to/media/

Prerequisites

Required software

audipomarks is written in JavaScript, and so you need to install Node.js 16.x and npm 8.x.

💡 I recommend using nvm for getting both node and npm. It also lets you to install packages globally (npm i -g ...) w/o administrator priviledges.

Media arrangement

Let's assume you have a folder with your media files somewhere on your phone, and also have it copied to your PC.

💡 Ideally you'd want to have this folder synced with your PC automatically, using tools like FolderSync or AutoSync. They do a really good job at syncing folders with cloud drives — Google Drive, Dropbox, Yandex.Disk etc

To be specific, let's imagine that you keep your media files at MyMedia/ on your phone:

/storage/emulated/0/MyMedia

and have it already copied to your PC at:

/home/me/MyMedia

💡 With FolderSync, you just add a folder-level rule, and get those two directories in sync all the time.

We'll refer this setup below.

Install

Global installation (recommended)

$ npm i -g audipomarks

Now you can run it from anywhere w/o any prefixes or paths, e.g.:

$ audipomarks <params>

Local installation (not recommended)

$ npm i audipomarks

Now you run audipomarks from the current directory as:

$ node_modules/.bin/audipomarks <params>

or with npx (part of npm):

$ npx audipomarks <params>

Exporting marks data

Open the Audipo app, go to Preferences, tap Export all marks data, then Audipo marks format on the next screen, and finally tap Share to save the marks file somewhere, from where you can easily transfer it to your PC.

npm.io

The filename will look like exportedmarks20220706_020654.audipomark.

Going back to our example, let's assume that you saved the file in MyMedia/ on your phone, and then copied it to /home/me/MyMedia/ on PC.

💡 With FolderSync, you'd have it copied automatically.

So now you should have your media files along with the exported all-marks file in your /home/me/MyMedia/:

/home/
  me/
    MyMedia/
      exportedmarks20220706_020654.audipomark
      Lessons/
        Lesson1.mp3
        Lesson2.mp3
        MoreLessons/
          NewLesson1.mp3
          NewLesson2.mp3
      Songs/
        ...

Commands

`split`

Now that you have your all-marks data file in place on your PC, you're ready to disassemble it through directories with the actual audio files:

$ audipomarks split --root=MyMedia /home/me/MyMedia/exportedmarks20220706_020654.audipomark

The required --root parameter specifies the location of the user media directory (MyMedia/) on your phone. It can use either absolute or relative path:

absolute, e.g.: /storage/emulated/0/MyMedia or
relative, i.e.: MyMedia

The split command will:

parse the all-marks file,
check all the directories and files from it,
split the data into smaller marks files
and save them under the local.audipomark name in the directories they refer to.

There is also an optional --normalize (-n) flag, which forces audipomarks to filter discovered marks. Basically, it removes all the marks which are too close to each other. The hard-coded proximity value now is 1 second (1000ms). When generating marks with the mark command (see below), normalization is performed automatically.

So you should end up with 3 new files:

/home/
  me/
    MyMedia/
      exportedmarks20220706_020654.audipomark
      Lessons/
        local.audipomark
        Lesson1.mp3
        Lesson2.mp3
        MoreLessons/
          local.audipomark
          NewLesson1.mp3
          NewLesson2.mp3
      Songs/
        local.audipomark
        ...

Working with directory-level marks files

Each local.audipomark file references only the files from the directory it's saved into.

For example, the first local.audipomark from above will keep marks from Lesson1.mp3 and Lesson2.mp3 but not from MoreLessons/ subdirectory.

Also, local.audipomark files don't keep their original (phone) locations and hence their containing directories can now be relocated according to your preferences.

Things you may want to do with now "disassembled" marks file:

Rename directories
Move directories to new locations within your media directory
Generate marks using tools like audio-silence-marks

`join`

After you're finished with refactoring locations of your media or with updating marks files, you're now ready to build the all-marks file and import it back into Audipo.

$ audipomarks join /home/me/MyMedia

This command will:

find all local.audipomark files below /home/me/MyMedia,
join them back into one solid marks file
and save it to /home/me/MyMedia/global.audipomark.

You can now import it back into Audipo:

Transfer the global.audipomark file to your phone.

💡 With FolderSync, you'd have it in place automatically.

Delete the old marks data: Preferences > Delete all mark data
Import the new all-marks file: Preferences > Import mark data

You're done, congratulations!

`mark`

Now that the functionality of audio-silence-marks has been ported into this tool, you can generate marks automatically for a directory or a directory tree.

$ audipomarks mark /home/me/MyMedia/Lessons

This command will run FFmpeg silencedetect filter against every file in that dir (only) and will generate local.audipomark file with the list of autodetected marks.

If you want it to operate recursively use --recursive (-r) flag:

$ audipomarks mark -r /home/me/MyMedia

The silencedetect FFmpeg filter takes two parameters: noise and duration. The default values audipomarks uses are:

duration = 1000 (ms) noise = 50 (dB)

You can override them via the command line:

$ audipomarks mark --duration 500 --noise 40 -r /home/me/MyMedia

During marks generation, special config files with the name .audiomarks will be created in every directory with audio files. It will contain the config parameters that have been used, e.g.:

{
  "ffmpeg": {
    "duration": 500,
    "noise": 40
  }
}

(The .audiomarks files will be created no matter whether you pass duration/noise parameters or not.)

The FFmpeg silencedetect filter may return intervals that are too close to each other. For this reason, audipomarks removes them. The hardcoded proximity threshold is 500ms.

Audipo and marks

Audipo

Music Speed Changer: Audipo is an audio player for Android.

It's a swiss-knife for tasks like:

learning foreign languages;
transcribing interviews and other audio recordings;
learning poems and songs.

It features:

Nice support for Bluetooth remote control devices.
Setting playback stop points called marks**.
Changing the pitch (to match your vocal range).
Changing the playback speed (this one is regular, but still...).

And many more.

Marks

Marks are a list of time codes. They are usually used as stop points by the player to allow for A-B repetition or fast and precise navigation through an audio recording.

In Audipo player you create marks by tapping the button.

You can also open the mark list in a separate window and fine-adjust any mark with the precision of hundredths of a second.

Audipo marks