tag generates artwork from your favourite terminal themes.
Usage:
tag [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
generate Create a new generative artwork
help Help about any command
list List all themes and styles
Flags:
-h, --help help for tag
-v, --version version for tag
Use "tag [command] --help" for more information about a command.
All you need is to have Go installed to compile tag.
To install tag, all you have to do is run the go install command.
$ go install github.com/rsHalford/tag@latestIf you're into Nix, tag has been setup so that you can just add the repo's URL to your flake.nix inputs. Then the overlay can be called by environment.systemPackages or per user with home.packages.
inputs = {
nixpkgs.url = "nixpkgs/nixos-unstable";
tag-flake = {
url = "github:rsHalford/tag";
inputs.nixpkgs.follows = "nixpkgs";
};
};Instructions on how to add tag as a flake can vary wildly depending on the system configuration. You can view my dotfiles to see a working example, and message me or create an issue on either repository if you need additional help getting setup.
You can edit the config.toml to set your preferred default settings, helping shorten your most used tag arguments.
On Linux this file will be read from ${XDG_CONFIG_HOME:-$HOME/.config}/tag/config.toml.
[general]
# location to save generated artwork (defaults to current working directory if unset)
directory = "" # $TAG_GENERAL_DIRECTORY
[canvas]
# width of the canvas to generate art with (defaults to "1920" pixels if unset)
width = "1920" # $TAG_CANVAS_WIDTH
# height of the canvas to generate art with (defaults to "1080" pixels if unset)
height = "1080" # $TAG_CANVAS_HEIGHT
[theme]
# default is the fallback theme to use for generative art (defaults to
# "rose_pine" if unset)
default = "rose_pine"To help contribute to tag, you could either send in your feature requests as an issue or take it upon yourself to send in a pull request after following the CONTRIBUTING guide.
Thanks in advance for taking an interest!
tag development is setup to utilise the following tools;
- git-chglog
- For updating the CHANGELOG.md
- gopls
- Go language server
Combined with nix flakes and nix-direnv, it is possible to create a .envrc file to make a portable isolated environment for development.
Meaning the above tools can be installed and setup just for this project by using the included .envrc found in the root of the project directory.
use flake
layout gotag wouldn't be possible without the below libraries.
tag is released under the MIT License.
See LICENSE.