Metadata-Version: 2.1
Name: acsuite-orangechannel
Version: 4.2.0
Summary: Frame-based cutting/trimming/splicing of audio with VapourSynth.
Home-page: https://github.com/OrangeChannel/acsuite
Author: Dave
Author-email: orangechannel@pm.me
License: UNLICENSE
Project-URL: Documentation, https://orangechannel.github.io/acsuite/html/index.html
Project-URL: Source, https://github.com/OrangeChannel/acsuite/blob/master/acsuite/__init__.py
Project-URL: Tracker, https://github.com/OrangeChannel/acsuite/issues
Description: # acsuite
        
        audiocutter(.py) replacement for VapourSynth.
        
        Allows for easy frame-based cutting/trimming/splicing of audio files
        using VapourSynth clip information.
        
        
        ## Functions:
        
        ### eztrim(clip, trims, audio_file[, outfile, mkvmerge_path=, ffmpeg_path=, quiet=])
        
        ```py
        import vapoursynth as vs
        core = vs.core
        from acsuite import eztrim
        
        file  = r'/BDMV/STREAM/00003.m2ts'
        afile = r'/BDMV/STREAM/00003.wav'  # pre-extracted with TSMuxer or similar
        
        src = core.lsmas.LWLibavSource(file)
        
        # for the example, we will assume the src clip is 100 frames long (0-99)
        trimmed_clip = src[3:22]+src[23:40]+src[48]+src[50:-20]+src[-10:-5]+src[97:]
        
        # `clip` arg should be the uncut/untrimmed source that you are trimming from
        eztrim(src, [(3,22),(23,40),(48,49),(50,-20),(-10,-5),(97,0)], afile)
        ```
        
        ##### Outputs:
        
        - If you have `ffmpeg` in your PATH or specify a path to an FFmpeg executable
        with `ffmpeg_path='/path/to/ffmpeg.exe'`,
        the script will automatically output a waveform audio file (`.wav`)
        named `/BDMV/STREAM/00003_cut.wav`.
        
        - If not, the script will output a Mastroka Audio file (`.mka`)
        named `/BDMV/STREAM/00003_cut.mka`.
        
        #### MKV container example
        
        ```py
        import vapoursynth as vs
        core = vs.core
        from acsuite import eztrim
        
        # no need to extract audio if using a container with a slice-able audio codec
        file = r'/path/to/remuxed_bdmv.mkv'  # Video: V_MPEG4/ISO/AVC, Audio: A_PCM/INT/LIT
        
        # trimmed_clip = src[0:-22]
        eztrim(core.lsmas.LWLibavSource(file), (0, -22), file, 'custom_name.mka')
        ```
        
        ##### Outputs:
        
        - If you have `ffmpeg` in your PATH or specify a path to an FFmpeg executable
        with `ffmpeg_path='/path/to/ffmpeg.exe'`,
        the script will automatically output a waveform audio file (`.wav`)
        named `custom_name.wav` in the directory the script is running from.
        
        - If not, the script will output a Mastroka Audio file (`.mka`)
        named `custom_name.mka` in the directory the script is running from.
        ---
        
        ## Getting Started
        
        ### Dependencies
        - [MKVToolNix](https://mkvtoolnix.download/downloads.html)
        - [VapourSynth R49+](https://github.com/vapoursynth/vapoursynth/releases)
        
        ##### Optional Dependencies
        - [FFmpeg](https://ffmpeg.org/) - needed to output WAV files instead of Mastroka Audio (MKA)
        
        ### Installing
        
        #### Arch Linux
        
        Install the [AUR package](https://aur.archlinux.org/packages/vapoursynth-tools-acsuite-git/) `vapoursynth-tools-acsuite-git` with your favorite AUR helper:
        
        ```sh
        $ yay -S vapoursynth-tools-acsuite-git
        ```
        
        #### Gentoo Linux
        
        Install via the [VapourSynth portage tree](https://github.com/4re/vapoursynth-portage).
        
        #### Windows / Other
        
        Use the [Python Package Index (PyPI / pip)](https://pypi.org/project/acsuite-orangechannel/#description):
        
        ```sh
        python3 -m pip install --user --upgrade acsuite-orangechannel
        ```
        
        or simply
        
        ```sh
        pip install acsuite-orangechannel
        ```
        
        if you are able to use a `pip` executable directly.
        
        ## Help!
        
        Check out the [documentation](https://orangechannel.github.io/acsuite/html/index.html) or use Python's builtin `help()`: 
        
        ```py
        help('acsuite')
        ```
        
        
Keywords: audio vapoursynth encoding trim cut
Platform: UNKNOWN
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: Public Domain
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
