ewenlau
f82cfb68d5
Release / check-release (push) Successful in 55s
Release / build_gnu (push) Skipped
Release / build_musl (push) Skipped
Release / build_windows (push) Skipped
Release / package_gnu (deb) (push) Skipped
Release / package_gnu (rpm) (push) Skipped
Release / package_musl (deb) (push) Skipped
Release / publish-release (push) Skipped
Release / package_musl (rpm) (push) Skipped
CI / Build Linux (push) Successful in 2m58s
CI / Test (push) Successful in 3m0s
57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
# Convertis
|
|
|
|
## Description
|
|
|
|
Convertis is a CLI tool to convert files from one format to another. It's main design goal is to be able to convert *any* format to *any* other format, including different types, like MP4 to JPEG, MP4 to MP3 and in the future more exotic paths like HTML to JPEG or PNG to ZIP.
|
|
|
|
As it attemps to effectively cover an infinite number of possible conversions, it uses a pathfinding algorithm, that may include multiple conversions before reaching the target goal.
|
|
|
|
## Installation
|
|
|
|
Convertis can be installed in a few ways.
|
|
|
|
Note: Convertis has three different targets "gnu", "musl" and "windows". The "gnu" build targets regular GNU/Linux systems, the "musl" build targets systems using the musl C standard library and the "windows" build targets windows systems. Only the "gnu" build is actively tested.
|
|
|
|
### Via repository
|
|
|
|
Convertis is available on GNU/Linux for Debian-based systems and Fedora/CentOS-based systems via my gitea repository.
|
|
|
|
Packages are published for both the gnu and musl targets, although the gnu build should always be preferred.
|
|
|
|
See <https://git.ewenlau.net/ewenlau/convertis/packages> for options.
|
|
|
|
### Manual package install
|
|
|
|
You may download a .deb file for Debian-based systems and a .rpm file for Fedora/CentOS-based systems from the releases page. You can then install the package using your system's package manager.
|
|
|
|
See <https://git.ewenlau.net/ewenlau/convertis/releases>
|
|
|
|
### Binary download
|
|
|
|
If you use Windows, do not use a supported linux system or do not want to install any packages, you can download a binary release from the releases page.
|
|
|
|
See <https://git.ewenlau.net/ewenlau/convertis/releases>
|
|
|
|
## Building
|
|
|
|
Building convertis is simple, you just need the Rust toolchain installed:
|
|
|
|
```sh
|
|
cargo build --release
|
|
```
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
convertis <input> <output> [options]
|
|
```
|
|
|
|
Options are available with the --help flag:
|
|
|
|
```sh
|
|
convertis --help
|
|
```
|
|
|
|
## License
|
|
|
|
Convertis is licensed under the GNU General Public License v3.0 exclusively. See LICENSE for more details. |