An automatic video converter using HandBrake CLI.
Project description
Handbrake Automatic Video File Batch Converter
An automatic video converter using HandBrake CLI to batch convert all files found in recursive mode. In other words, all videos found on a given folder, and subsequent folders, will be converted on original location while original file will be transferred to another folder for easy removal.
HandBrake
This is a video converter and the HandBrake GUI can be found here, which also has a HandBrake CLI.
For more information, follow this link.
Table of Contents
Description
Given a specific folder, all video files found with user-given extensions will be converted to a target extension also provided by the user.
The converted video file will stay in the original folder while the original file will be transferred to another folder. This has the benefit of easy removal of the original files, as well as if a file does not encode successfully the original file still exists and can be converted again.
The program also accepts a user custom command which must have placeholders to be replaced by the original file path and converted file path.
In a first use of the program, all given arguments will be saved in a external file so the user does not have to always write the same repeated command.
In the end, an output file will be created containing:
- all the files' information, files' original size and converted size;
- if the file was successfully encoded;
- the size difference between all files;
- a list of files and their absolute paths which were not converted successfully;
- a list of files and their absolute paths which were skipped during encoding.
Initially, this project has the aim of reducing files size to ocupy the least amount of space in the disk and comparing between original size and converted size, but since a user can input a custom command, this can also be used just to convert a lot of files in a folder for other purposes.
Features
Status | Feature |
---|---|
✅ | convert a lot of files in their corresponding folders |
✅ | convert files with multiple different extensions at the same time |
✅ | transfer of original files in an external folder for easy removal |
✅ | configurations will be saved in an external file |
✅ | use of an automatic basic command aimed to reduce file size |
✅ | a custom HandBrake command with placeholders can also be inserted |
✅ | output file containing converted files information and their success |
✅ | option to shutdown computer when program is done |
✅ | when duplicate files exists these are skipped. |
Any new features are very welcome! Please open an issue to make a request.
Skipped Files
- Program will skip files if it encounters duplicate files (with the same name and target extension), not doing anything with them. This information will be added to the output file summary.
Future features
- Currently, this program only uses the Handbrake encoding tool. In the future, it will be implemented an option to also use the FFmpeg encoding tool. The user can then choose which one best suits him/her.
Prerequisites
Python 3 must also be installed.
To use this project, the HandBrake command line version must be installed. This installation can be found in this link under 'Downloads->Other->Command Line Version'
You will also need the ffmpeg CLI. You can find the link here.
For Linux Users (Debian/Ubuntu)
The HandBrake CLI can be installed by following the next commands:
sudo apt update
sudo apt install handbrake-cli
which HandBrakeCLI
Installation
pip --no-cache-dir install havc
or,
pip3 --no-cache-dir install havc
Usage
Command | Required | Description |
---|---|---|
-r | ✅ | absolute path folder to the HandBrake.exe (command line version) |
-c | ✅ | absolute path folder containing the files to convert |
-e | ✅ | multiple file extensions to find and convert |
-t | ✅ | file extension the converted file will have |
-d | ❌ | folder's name or an absolute path to the folder which will contain original files |
-cc | ❌ | custom handbrake command with placeholders (now reusable) |
--safety-question / --no-safety-question |
❌ | enable or disable the safety question |
--shutdown / --no-shutdown |
❌ | enable or disable shutting down computer when program is done |
--enable-delete / --no-enable-delete |
❌ | if disabled, original files will not be moved to an external folder. they will stay in the same folder as the converted files |
Notes
- First command must have all required arguments except if these arguments already are configured in external file.
- Non-required arguments will also be saved in the external file if specified.
- The folder containing original filed has the default name of 'TO-DELETE' and the default path, if none is given, is the same directory as the path folder containing the files to convert.
- The dot '.' before each extension is completely optional.
- Because the program modifies the original files by moving them to another folder, one must be certain the correct folder is being modified so there is a question to make sure the user wants to continue. However, this feature can be disabled to let the program run freely, but be warned. The default of this value is 'true'.
- Shutting down the computer is disabled, by default.
- Disabling deletion of files, means that original files will remain in the same folder as converted files. This is true by default. Option does not get persisted between runs.
Any additional help can be provided if the following command is run:
havc --help
or,
havc -h
Example of the initial command:
havc -r "C:\path\to\Desktop" -c "C:\path\to\Desktop\folder to convert" -e mp4 mkv -t m4v
After this, the external file will be configured and then the following command becomes valid (always using the previous configurations):
havc
If any argument has to be modified just run the command with the necessary argument, for instance, if the extensions have to be modified, we simply run:
havc -e mov .avi mp4
Support
The following links contain documentation about how to make a HandBrake command:
License
Status
This project started as a simple one file script, but then I saw the opportunity to make a program more complex that could also not only help the community, but also help my development. With that said, this project was also developed for educational purposes, so any bugs, suggestions, new features, improvements, etc, don't hesitate to ask, open an issue or a pull request.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file havc-1.4.0.tar.gz
.
File metadata
- Download URL: havc-1.4.0.tar.gz
- Upload date:
- Size: 18.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9874a998aa1a0b01a1222f5e6e7cd1b83a226f130fea16992881e364d11eea44 |
|
MD5 | 45df2a74ae318a182e473e1e98e72fd1 |
|
BLAKE2b-256 | 88cf07dfca330fa907f5696b8f6d5ed91388dce2cf5b3ecf9deeb01562d2f581 |
Provenance
File details
Details for the file havc-1.4.0-py3-none-any.whl
.
File metadata
- Download URL: havc-1.4.0-py3-none-any.whl
- Upload date:
- Size: 19.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 569304d9a2bdbed1b100fb4b6b0acc77e6400ff2335710c987281cc509294b21 |
|
MD5 | 305c25f64cbf98fdfd17ff9fbb3856a3 |
|
BLAKE2b-256 | 576b779ea272d17c3fe9e25a93a8dd5c3ae15340704e934bc962a0e00af5463a |