Elias Wendland
e46696c521
Release / check-release (push) Successful in 16s
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 / package_musl (rpm) (push) Skipped
Release / publish-release (push) Skipped
CI / Test (push) Successful in 1m35s
CI / Build Linux (push) Successful in 1m54s
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. |