a67eb72848
- Don't fail now that archive contains directory - Change default install location to `~/bin` - Suggestion installing in ~/bin - Add instructions to create `~/bin`, install there, and add `~/bin` to the PATH variable. type: distribution pr: https://github.com/casey/intermodal/pull/352
125 lines
4.3 KiB
Markdown
125 lines
4.3 KiB
Markdown
# intermodal: a 40' shipping container for the Internet
|
|
|
|
[](https://crates.io/crates/imdl)
|
|
[](https://github.com/casey/intermodal/actions)
|
|
[](https://imdl.io/book/)
|
|
[](https://discord.gg/HaaT5Qz)
|
|
|
|
Intermodal is a user-friendly and featureful command-line BitTorrent metainfo utility. The binary is called `imdl` and runs on Linux, Windows, and macOS.
|
|
|
|
At the moment, creation, viewing, and verification of `.torrent` files is supported.
|
|
|
|
For more about the project and its goals, check out [this post](https://rodarmor.com/blog/intermodal).
|
|
|
|
|
|
|
|
## Manual
|
|
|
|
- [General](#general)
|
|
- [Installation](#installation)
|
|
- [Supported Operating Systems](#supported-operating-systems)
|
|
- [Pre-built binaries](#pre-built-binaries)
|
|
- [Cargo](#cargo)
|
|
- [Shell Completion Scripts](#shell-completion-scripts)
|
|
- [Semantic Versioning](#semantic-versioning)
|
|
- [Unstable Features](#unstable-features)
|
|
- [Source Signatures](#source-signatures)
|
|
- [Acknowledgments](#acknowledgments)
|
|
|
|
## General
|
|
|
|
### Installation
|
|
|
|
#### Supported Operating Systems
|
|
|
|
`imdl` supports Linux, MacOS, and Windows, and should work on other unix OSes.
|
|
If it does not, please open an issue!
|
|
|
|
#### Pre-built binaries
|
|
|
|
Pre-built binaries for Linux, macOS, and Windows can be found on
|
|
[the releases page](https://github.com/casey/intermodal/releases).
|
|
|
|
You can use the following command to download the latest binary for Linux,
|
|
MacOS, or Windows, just replace `DEST` with the directory where you'd like to
|
|
install the `imdl` binary:
|
|
|
|
```sh
|
|
curl --proto '=https' --tlsv1.2 -sSf https://imdl.io/install.sh | bash -s -- --to DEST
|
|
```
|
|
|
|
A good place to install personal binaries is `~/bin`, which `install.sh` uses
|
|
when `--to` is not supplied. To create the `~/bin` directory and install `imdl`
|
|
there, do:
|
|
|
|
```sh
|
|
curl --proto '=https' --tlsv1.2 -sSf https://imdl.io/install.sh | bash
|
|
```
|
|
|
|
Additionally, you'll have to add `~/bin` to the `PATH` environment variable,
|
|
which the system uses to find executables. How to do this depends on the shell.
|
|
|
|
For `sh`, `bash`, and `zsh`, it should be done in `~/.profile`:
|
|
|
|
```sh
|
|
echo 'export PATH=$HOME/bin:$PATH' >> ~/.profile
|
|
```
|
|
|
|
For `fish`, it should be done in `~/.config/fish/config.fish`:
|
|
|
|
```fish
|
|
echo 'set -gx PATH ~/bin $PATH' >> ~/.config/fish/config.fish
|
|
```
|
|
|
|
#### Cargo
|
|
|
|
`imdl` is written in [Rust](https://www.rust-lang.org/) and can be built from
|
|
source and installed with `cargo install imdl`. To get Rust, use the
|
|
[rustup installer](https://rustup.rs/).
|
|
|
|
### Shell Completion Scripts
|
|
|
|
Shell completion scripts for Bash, Zsh, Fish, PowerShell, and Elvish are
|
|
available in the [completions](completions directory). Please refer to your
|
|
shell's documentation for how to install them.
|
|
|
|
The `imdl` binary can also generate the same completion scripts at runtime,
|
|
using the `completions` command:
|
|
|
|
```sh
|
|
$ imdl completions --shell bash > imdl.bash
|
|
```
|
|
|
|
### Semantic Versioning
|
|
|
|
Intermodal follows [semantic versioning](https://semver.org/).
|
|
|
|
In particular:
|
|
|
|
- v0.0.X: Breaking changes may be introduced at any time.
|
|
- v0.X.Y: Breaking changes may only be introduced with a minor version number
|
|
bump.
|
|
- vX.Y.Z: Breaking changes may only be introduced with a major version number
|
|
bump
|
|
|
|
### Unstable Features
|
|
|
|
To avoid premature stabilization and excessive version churn, unstable features
|
|
are unavailable unless the `--unstable` / `-u` flag is passed, for example
|
|
`imdl --unstable torrent create .`. Unstable features may be changed or removed
|
|
at any time.
|
|
|
|
### Source Signatures
|
|
|
|
All commits to the intermodal master branch signed with Casey Rodarmor's PGP
|
|
key with fingerprint `3259DAEDB29636B0E2025A70556186B153EC6FE0`, which can be
|
|
found
|
|
[on keybase](https://keybase.io/rodarmor/pgp_keys.asc?fingerprint=3259daedb29636b0e2025a70556186b153ec6fe0) and on
|
|
[his homepage](https://rodarmor.com/static/rodarmor.asc).
|
|
|
|
## Acknowledgments
|
|
|
|
The formatting of `imdl torrent show` is entirely copied from
|
|
[torf](https://github.com/rndusr/torf-cli), an excellent command-line torrent
|
|
creator, editor, and viewer.
|