https://github.com/mmastrac/automedia

Skip to content
 
Sign up

  * Product
      + Features
      + Mobile
      + Actions
      + Codespaces
      + Packages
      + Security
      + Code review
      + Issues
      + Integrations
      + GitHub Sponsors
      + Customer stories
  * Team
  * Enterprise
  * Explore
      + Explore GitHub
      + Learn and contribute
      + Topics
      + Collections
      + Trending
      + Learning Lab
      + Open source guides
      + Connect with others
      + The ReadME Project
      + Events
      + Community forum
      + GitHub Education
      + GitHub Stars program
  * Marketplace
  * Pricing
      + Plans
      + Compare plans
      + Contact Sales
      + Education

[                    ] 

  *  
    #
    In this repository All GitHub |
    Jump to |

  * No suggested jump to results

  *  
    #
    In this repository All GitHub |
    Jump to |
  *  
    #
    In this user All GitHub |
    Jump to |
  *  
    #
    In this repository All GitHub |
    Jump to |

Sign in
Sign up
{{ message }}

mmastrac / automedia Public

  * Notifications
  * Fork 1
  * Star 45

A set of tools for automatically managing bitrot and format in large
quantities of media

License

GPL-3.0 license
45 stars 1 fork
Star
Notifications

  * Code
  * Issues 0
  * Pull requests 0
  * Actions
  * Projects 0
  * Wiki
  * Security
  * Insights

More

  * Code
  * Issues
  * Pull requests
  * Actions
  * Projects
  * Wiki
  * Security
  * Insights

This commit does not belong to any branch on this repository, and may
belong to a fork outside of the repository.
main
Switch branches/tags
[                    ]
Branches Tags
Could not load branches
Nothing to show
{{ refName }} default View all branches
Could not load tags
Nothing to show
{{ refName }} default
View all tags
1 branch 3 tags
Code

Latest commit

@mmastrac
mmastrac PyPI badge w/version and link
...
be12c31 May 8, 2022
PyPI badge w/version and link
be12c31

Git stats

  * 38 commits

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
docs
Add a screenshot
Apr 18, 2022
src/automedia
Add more presets
Apr 18, 2022
test
Add a test PDF
Apr 10, 2022
.gitignore
Add pyproject.toml and prepare for packaging
Apr 11, 2022
Dockerfile
Add auto-versioning build
Apr 15, 2022
LICENSE
Add pyproject.toml and prepare for packaging
Apr 11, 2022
README.md
PyPI badge w/version and link
May 8, 2022
automedia
Add pyproject.toml and prepare for packaging
Apr 11, 2022
automedia-docker
Remove the docker container after running
Apr 10, 2022
make.sh
Don't hardcode version (oops)
Apr 18, 2022
pyproject.toml
Bump version to v0.6
Apr 18, 2022
View code
[                    ]
Automedia But why? Requirements Installation Via pip Via Docker Usage
Screenshots

README.md

 Automedia

PyPI

Automedia is a tool to manage bitrot and formats in large media
libraries, whether it be audio or video.

The tool currently supports the following operations:

  * Printing/logging to list media files: view your media files at a
    glance
  * Verification of media correctness via ffmpeg: test-decoding of
    supported files to find bitrot
  * Transcoding media libraries to other formats via ffmpeg: archive
    your media in a lossless/high-quality format, transcode for daily
    use or for older devices
  * PAR2 creation and verification: prevent future bitrot of data at
    rest

 But why?

You can replace much of what this tool does using find, xargs, grep
and a dash of scripting, but automedia deals with all of the
incantations itself and has some intelligence to handle interaction
with complex tools like as ffmpeg.

 Requirements

automedia requires the ffmpeg and par2 executables to be fully
operational. These must exist on the path for the application to
function. It is recommended to use the dockerized version of this
application as these requirements will be packaged up with it.

 Installation

automedia can be installed via pip, or can be run with all binary
dependencies in a Docker container.

 Via pip

Automedia is available as a pip package. You can download it with:

pip install automedia
automedia --help

 Via Docker

If you wish to run Automedia via Docker, a script has been provided
that transparently runs Automedia on your machine as if it were not
running within a container (by mounting the entire root of your drive
within the container).

This script may be copied to a directory on your local $PATH and will
automatically invoke the appropriate Docker container.

cp automedia-docker /usr/local/bin/automedia
automedia --help

 Usage

Print a list of media files we find:

automedia --root /media print

Verify the media files we find using ffmpeg:

automedia --root /media verify

Transcode the media files from /media to /mnt/usb_stick to 64k AAC
format:

automedia --root /media transcode --preset aac-64k --output=/mnt/
usb_stick

Transcode the media files from /media to /mnt/usb_stick to FLAC
format:

automedia --root /media transcode --preset flac --output=/mnt/
usb_stick

Create PAR2 files for the media files we find:

automedia --root /media par2-create

Verify PAR2 files for the media files we find:

automedia --root /media par2-verify

 Screenshots

An animated GIF showing automedia running a verify operation

About

A set of tools for automatically managing bitrot and format in large
quantities of media

Topics

python ffmpeg mp4 mp3 media python3 flac par2

Resources

Readme

License

GPL-3.0 license

Stars

45 stars

Watchers

1 watching

Forks

1 fork

Releases 1

 
Initial functional release Latest
Apr 11, 2022

Packages 0

No packages published

Languages

  * Python 93.7%
  * Shell 4.7%
  * Dockerfile 1.6%

  *  (c) 2022 GitHub, Inc.

  * Terms
  * Privacy
  * Security
  * Status
  * Docs
  * Contact GitHub
  * Pricing
  * API
  * Training
  * Blog
  * About

You can't perform that action at this time.
You signed in with another tab or window. Reload to refresh your
session. You signed out in another tab or window. Reload to refresh
your session.