Build/Dependencies

• docker engine is required (see https://docs.docker.com/engine/install/ for installation instructions)
• use ./build to build the image

Usage

• IMPORTANT: all io-related files must be stored in io directory, as this path will be forwarded to the docker environment (see example below)!
• syntax: ./mp3fsa [-h] -i INPUT [-o OUTPUT] [-d] [-f] [-r] [--hex]
• the INPUT file has to be the MP3 file to be analysed
• the (optional) OUTPUT will be a JSON file with a detailed description of the file-structure
• use -d flag to include mpeg frame data in output JSON
• use -f flag to enable overwriting of output path

Example

• ./mp3fsa -i io/Sine30s.VBR.mp3 -o io/Sine30s.VBR.mp3.json -d
• ./mp3fsa -i io/Sine30s.VBR.mp3.json -o io/Sine30s.VBR.mp3.json.mp3 -r
• md5sum io/Sine30s.VBR*.mp3

Build/Use without Docker

• when aiming to avoid ussage docker, the tool can be utilized directly within a designated pyhton-venv.
• for simplictiy a simple bash-script is provided. (supporting the commands: install, run, reconstruct and help)
  • to view usage information: bash use_without_docker.sh help
  • for cloning and installing use: bash use_without_docker.sh install myinstalllocation

Credits

• MP3 decoder by tomershay100 (https://github.com/tomershay100/mp3-steganography-lib)