Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/whiteblackgoose/tri
Work with images incrementally and reproducibly!
https://github.com/whiteblackgoose/tri
Last synced: about 1 month ago
JSON representation
Work with images incrementally and reproducibly!
- Host: GitHub
- URL: https://github.com/whiteblackgoose/tri
- Owner: WhiteBlackGoose
- License: gpl-3.0
- Created: 2023-03-28T12:04:38.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-07-06T11:21:35.000Z (over 1 year ago)
- Last Synced: 2024-10-06T09:02:58.848Z (about 1 month ago)
- Language: Rust
- Homepage: https://whiteblackgoose.github.io/tri/
- Size: 1.89 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# TRI
[![tests](https://github.com/WhiteBlackGoose/tri/actions/workflows/tests.yml/badge.svg)](https://github.com/WhiteBlackGoose/tri/actions/workflows/tests.yml)
[![Install via Nix](https://img.shields.io/badge/Install%20via%20Nix-7eb7e2?logo=nixos&style=flat-square&labelColor=4c6eb4&logoColor=white)](https://nixos.org/download.html)
[![Built with Rust](https://img.shields.io/badge/Built%20with%20Rust-F49300?logo=rust&style=flat-square&labelColor=F74C00&logoColor=white)](https://www.rust-lang.org/)`TRI` is like git but for image manipulation.
## Usage
First, initialize the repo.
```
tri init --path image.png
```Now you can make commits using any ImageMagick command, e. g.:
```
tri commit crop 50x50+0x0tri commit monochrome
tri commit rotate 90
```Check logs:
```
tri log
```Print commit tree:
```
tri tree
```Reset the HEAD to another commit by specifying the unique first few characters of the hash (run tri tree or log to see the hashes):
```
tri reset 9f
```## Installation
### Most users
#### 1. Install nix [**Nix official instruction**](https://nixos.org/download.html)
#### 2. Run installation
```
nix profile install github:WhiteBlackGoose/tri \
--extra-experimental-features 'nix-command flakes'
```#### 3. Enable tab completion
```
export XDG_DATA_DIRS="~/.nix-profile/share:$XDG_DATA_DIRS"
```
to your `.bashrc` (or your shell's corresponding file).### NixOS flake users
If you're a NixOS user, add this repo as flake input:
```nix
tri-input.url = "github:WhiteBlackGoose/tri";
```
Then you can add it as module:
```nix
{ environment.systemPackages = [ tri-input.packages.${system}.default ]; }
```### Manual installation
You will need Rust, imagemagick. Build the repo, and optionally install man pages and shell completions from ./artifacts.
## Documentation
If you run Nix, you can simply call
```
man tri
```If you do not run Nix on Linux, you can see the man-page manually by calling the following command in the project folder after you built the project (using cargo build):
```
man ./artifacts/tri.1
```Or refer to [web version](https://whiteblackgoose.github.io/tri/).