Metadata-Version: 1.1
Name: OATS
Version: 0.2.5
Summary: A tool for the transcoding of audio from lossless sources
Home-page: https://github.com/leinfirmier/OATS
Author: UNKNOWN
Author-email: UNKNOWN
License: UNKNOWN
Download-URL: https://github.com/leinfirmier/OATS/archive/0.2.5.tar.gz
Description: # OATS
        OATS is Another Transcoding Script
        
        OATS is a commandline tool that makes transcoding easy on Windows, Linux, or Mac.
        The only prerequisites for OATS are FFmpeg and Python3. It can also make
        torrents.
        
        ## A quick intro
        
        OATS has one main script, called `oats`. Once installed you can make a quick
        config file to get started:
        
          `oats mkconfig`
        
        This will make a file in the current working directory named `oats.conf`. The
        options accessible there are the same as in the interface, so you can configure
        the defaults for your use. Any options specified at the command line take
        priority over the config file. All options not supplied to the command line
        will use their values set in the config file.
        
        To see the options for `oats`, access the help:
        
          `oats -h`
        
        Here's a sample command for transcoding two albums to MP3 at constant bitrate of 320
        and MP3 of variable bitrate, quality 2, resulting files will be put into a directory
        named `transcodes`:
        
          `oats --output-dir transcodes --formats "MP3 CBR 320,MP3 VBR 2" Album1 Album2`
        
        ## What formats can I use?
        
        The best way to see what audio formats you can use is to enter
        
          `oats -F`
        
        which will print a list of all available formats on your system. Formats may
        allow parsed arguments which will be described per
        `{name;units:restrictions}`. For instance "MP3 CBR {bitrate;kbps:8-320}"
        indicates that MP3 constant bitrate accepts values in kbps between 8 and 320.
        
        ## Torrent creation options
        
        The following options pertain to torrent creation: `--torrent=<bool>`,
        `--announce-url=<url>`, `--torrent-dir=<dir>`, and `--source=<str>`. A full
        example of these options is given here.
        
          `oats --torrent true --torrent-dir torrent_output --announce-url https://blah.com MyAlbum`
        
        ## Tool Extensibility in OATS
        
        OATS is a frontend to a variety of audio codec tools. In its first iteration it
        was just a frontend to FFmpeg, but now is able to modularly use different tools
        and dynamically detect what is available. For instance, if you install LAME on
        your system, and "lame" can be found on the path, OATS will attempt to
        encode your MP3s with it instead of FFmpeg (currently, FFmpeg's Xing header is
        considered deficient). Similarly, Opus Tools' `opusenc` and `opusdec`, and
        Vorbis Tools' `oggenc` and `oggdec` will be employed over FFmpeg.
        
        FFmpeg provides a good baseline of support for most formats, and you may never
        need anything else. I hope to also add Sound eXchange (SoX) in the future as
        a general tool.
        
        ## TODO - Things I want to do that are not yet done
        
         * ALAC support
         * AAC support
         * SoX Codecs
         * Channel Ops?
         * Possibly provide workaround for Windows Powershell tab-completion bug
         * magnet link support
        
Platform: UNKNOWN
Classifier: Intended Audience :: End Users/Desktop
Classifier: Environment :: Console
Classifier: License :: Public Domain
Classifier: Topic :: Multimedia :: Sound/Audio :: Conversion
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
