Package: shane
ShaneShane is a handy module for converting and demuxing video files.Change a container for MKV or MP4 without slow re-encoding.Add new streams to the container (and delete other ones easily)View and change the metadata of a container and of all its streamsIt is a new look at some common tasks for FFmpeg (you don't need to know FFmpeg syntax). In fact, you just change some media file attributes, likeextensionorfps, and save these changes (see examples below).CONTENTSINSTALLATIONHOW TOOpen the media fileChange the format to another oneDelete all audio tracks that are not EngilshAdd subtitlesSave the changesUSAGEOpen a fileDiscover the media informationChange what you wantINSTALLATIONInstallFFmpeg. You can install it using Homebrew on Mac:brew install ffmpeg --with-x265Install Shane with pip:pip install shaneNote, that onlyPython 3.6+is supported.HOW TOOpen the media file:>>> import shane
>>> container = shane.open('path/to/file.mkv')Change the format to another one:NOTE:It will be executed fast if the input container codecs are supported by the output container.>>> container.extension = '.m4v'Delete all audio tracks, that are not Engilsh:>>> not_eng = lambda s: s.is_audio and s.metadata['language'] != 'eng'
>>> container.remove_streams_if(not_eng)Add subtitles:>>> subtitles = shane.open('path/to/fre_subtitles.srt')
>>> subtitles.metadata['language'] = 'fre'
>>> container.streams.append(subtitles)Extract subtitles:>>> subtitles = container.subtitles[0]
>>> subtitles = subtitles.extract(path='new_path/to/rus_subtitles.srt')Save the changes:After all the changes, the file must be saved.NOTE:If thepathor theextensionof a file was not changed, the file will be overwritten.>>> container.save()USAGEShane operates with two kinds of objects:streamsandcontainers. Streams areseparatevideo/audio/subtitles files and containers contain a number of streams.Open a fileTheopenfunction chooses the object type that needs to be created itself.Open the file with several video/audio/subtitles tracks in it:>>> container = shane.open('path/to/file.mkv')
Container(path=path/to/file.mkv, size=142.65 MB, duration=00:02:00)Open the file that contains only video, without any audio or subtitles:>>> video_stream = shane.open('path/to/only_video.mkv')
VideoStream(path=path/to/file.mkv, codec=h264, fps=23.97598627787307, width=1272, height=720, language=eng)Open an audio or subtitles file:>>> audio_stream = shane.open('path/to/audio.aac')
AudioStream(path=path/to/audio.aac, codec=aac, channels=2, sample_rate=48000.0, language=eng)

>>> subtitle_stream = shane.open('path/to/subtitles.srt')
SubtitleStream(path=path/to/subtitles.srt, codec=subrip, is_forced=False, language=rus)Discover the media informationGet thelistof all streams inside the container:>>> container.streams
...Gettupleof streams of a certain type:>>> container.audios
...
>>> container.subtitles
...
>>> container.videos
...Get the metadata:# global metadata
>>> container.metadata
{'title': 'Untitled Movie File'}

# metadata of a certain stream
>>> *_, last_audio_stream = container.audios
>>> last_audio_stream.metadata
{'language': 'eng', 'title': 'Commentary', 'DURATION': '00:02:00'}Get chapters:>>> container.chapters
...Get other media information:>>> container.path
'path/to/file.mkv'

>>> container.extension
'.mkv'

>>> container.duration
120.0

>>> container.human_duration
'00:02:00'

>>> container.size
149575198

>>> container.human_size
'142.65 MB'

>>> video, *_ = container.videos
>>> video.fps
23.976023976023978

>>> video.codec
'h264'Change what you wantAll the changes to the container are performed by means of changing of its attributes and the following saving.Change the file extension:>>> container.extension = '.m4v'

>>> container.path
'path/to/file.m4v'Change the global metadata:>>> container.metadata['author'] = "John Dou"Or delete the global metadata at all:>>> container.metadata = {}Change the FPS of the video stream inside the container:>>> video_stream, *_ = container.videos
>>> video_stream.fps = 23Change the frame size:>>> video_stream.width = 640
>>> video_stream.height = 480And don't forget to save the changes:>>> container.save()