Metadata-Version: 1.1
Name: tagtool
Version: 1.0.6
Summary: Tagtool allows you to perform mass ID3 tag cleaning operations.
Home-page: https://github.com/dufferzafar/tagtool
Author: Shadab Zafar
Author-email: dufferzafar0@gmail.com
License: MIT
Description: tagtool
        =======
        
        Mass clean metadata of downloaded MP3 songs.
        
        I wrote the initial version as a `simple
        script <https://github.com/dufferzafar/tagtool/blob/old/tagfix.py>`__
        that just worked. This tool later became an exercise in command line
        application design as I'd never done it before. It uses
        `docopt <http://docopt.org/>`__ (along with some hackery to allow
        sub-commands)
        
        install
        -------
        
        ``pip install tagtool``
        
        You could also use ```pipsi`` <https://github.com/mitsuhiko/pipsi>`__ to
        install.
        
        usage
        -----
        
        ::
        
            Usage:
                tagtool [--no-skip] <command> [<args>...]
        
            Commands:
                replace     Perform regex replace on tags
                remove      Remove tag frames
                rename      Rename files to format: "%TrackTitle%.mp3"
                help        Read about a specific command
        
            Options:
                --no-skip   Do not skip already tagged files
        
        commands
        --------
        
        **``replace``**
        
        ::
        
            Perform regex replace on tags like artist name, track title etc.
        
            Usage:
                tagtool replace --pattern=<pattern> [--repl=<replacement>] <file>...
                                [--prune] [--frames=<tags>] [--frames_skip=<tags>]
        
            Options:
                <file>                       MP3 file(s) to process
                --pattern=<pattern>          Pattern to search for
                --repl=<replacement>         Replacement text
                --prune                      Remove empty frames
                --frames=<frames>            Comma separated list of frames to
                                             restrict replacement to
                --frames_skip=<frames>       Comma separated list of frames to skip
        
            Examples:
                tagtool replace --pattern='\s+\d+\s+' --repl='' --prune SomeSong.mp3 --frames_skip=TOPE,TIT2
        
        **``remove``**
        
        ::
        
            Remove tag frames.
        
            Usage:
                tagtool remove  --frames=<tags> <file>...
                                [--prefix]
        
            Options:
                <file>                       MP3 file(s) to process
                --frames=<frames>            Comma separated list of frames to remove
                --prefix                     Consider the list of frames as prefixes
        
            Examples:
                tagtool remove --frames=APIC,COMM,USLT *.mp3
        
        **``rename``**
        
        ::
        
            Rename a file with it's track title.
        
            Usage:
                tagtool rename <file>...
        
            Options:
                <file>                       MP3 file(s) to process
        
            Examples:
                tagtool rename *.mp3
        
        tagfix
        ------
        
        Tagfix is a script that uses the available tagtool commands as building
        blocks and performs multiple cleaning operation on files in one pass. If
        you download music from sites like `songspk <http://songspk.cc/>`__,
        `djmaza <www.djmaza.info/>`__ etc. then this script is for you. It
        removes all mention of these websites from the tags.
        
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
