{"id":13681392,"url":"https://github.com/bcicen/tcolors","last_synced_at":"2025-07-21T16:36:22.131Z","repository":{"id":45855825,"uuid":"176505806","full_name":"bcicen/tcolors","owner":"bcicen","description":"Commandline color picker and palette builder","archived":false,"fork":false,"pushed_at":"2024-03-11T08:57:22.000Z","size":128,"stargazers_count":56,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-18T08:48:09.324Z","etag":null,"topics":["cli","color-palette","color-picker","commandline","terminal"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcicen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-19T12:20:27.000Z","updated_at":"2025-02-19T08:59:37.000Z","dependencies_parsed_at":"2024-08-02T13:20:19.615Z","dependency_job_id":null,"html_url":"https://github.com/bcicen/tcolors","commit_stats":null,"previous_names":["bcicen/color_scale"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcicen%2Ftcolors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcicen%2Ftcolors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcicen%2Ftcolors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcicen%2Ftcolors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcicen","download_url":"https://codeload.github.com/bcicen/tcolors/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244912800,"owners_count":20530764,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","color-palette","color-picker","commandline","terminal"],"created_at":"2024-08-02T13:01:30.209Z","updated_at":"2025-03-22T05:31:18.298Z","avatar_url":"https://github.com/bcicen.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg width=\"300px\" src=\"https://bradley.codes/static/img/tcolors/logo.png\" alt=\"tcolors\"/\u003e\u003c/p\u003e\n\n**\u003cp align=\"center\"\u003eCommandline color picker and palette builder\u003c/p\u003e**\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://bradley.codes/static/img/tcolors/screencap.png\" alt=\"tcolors\"/\u003e\u003c/p\u003e\n\n## Overview\n`tcolors` is a commandline application for creating palettes of one or more colors in HSV space. Created palettes and their colors may be output in several different formats for import and use into other programs.\n\nColors are imported from, and changes automatically saved to, a human-readable TOML format file.\n\n## Installing\n\nGo get with:\n\n```bash\ngo install github.com/bcicen/tcolors@latest\n```\n\nOr download the [latest release](https://github.com/bcicen/tcolors/releases) for your platform:\n\n#### Linux / OSX\n\n```bash\ncurl -Lo tcolors https://github.com/bcicen/tcolors/releases/download/v0.3.2/tcolors-0.3.2-$(uname -s)-amd64\nchmod +x tcolors\nsudo mv tcolors /usr/local/bin/\n```\n#### AUR\n\n`tcolors` is also available for Arch in the [AUR](https://aur.archlinux.org/packages/tcolors)\n\n#### Docker\n\n```bash\ndocker run --rm -ti --name=tcolors \\\n  quay.io/vektorlab/tcolors:latest\n```\n\n## Usage\n\nSimply run `tcolors` to view and modify the default palette. Changes are automatically saved and will persist across sessions.\n\n### Keybindings\n\nKey | Description\n--- | ---\n`↑, k` | navigate up\n`↓, j` | navigate down\n`←, h` | decrease selected value\n`→, l` | increase selected value\n`\u003cshift\u003e + ←/→/h/l` | more quickly increase/decrease selected value\n`a, \u003cins\u003e` | add a new palette color\n`x, \u003cdel\u003e` | remove the selected palette color\n`q, \u003cesc\u003e` | exit tcolors\n`?` | show help menu\n\n### Palette files\n\nTo create a new palette or use a specific palette, use the `-f` option:\n\n```bash\ntcolors -f logo-palette.toml\n```\n\nPalette colors are stored in a human-readable TOML format and all changes are saved on exit.\n\n### Output\n\nIn addition to a stored TOML palette file, `tcolors` provides several output options for parsing and using defined colors\n\n#### All\n\nDefault output option providing a formatted table of colors\n\n```bash\n# tcolors -p\n+----+--------+-------------+-------------+------------------------------------+\n| #  |  HEX   |     HSV     |     RGB     |                TERM                |\n+----+--------+-------------+-------------+------------------------------------+\n| bg | 141414 | 000 000 008 | 020 020 020 | \\033[38;2;020;020;020m$@\\033[0;00m |\n|  0 | FF7733 | 020 080 100 | 255 119 051 | \\033[38;2;255;119;051m$@\\033[0;00m |\n|  1 | FFDD33 | 050 080 100 | 255 221 051 | \\033[38;2;255;221;051m$@\\033[0;00m |\n|  2 | C8FF59 | 080 065 100 | 200 255 089 | \\033[38;2;200;255;089m$@\\033[0;00m |\n|  3 | 55FF33 | 110 080 100 | 085 255 051 | \\033[38;2;085;255;051m$@\\033[0;00m |\n|  4 | 33FF77 | 140 080 100 | 051 255 119 | \\033[38;2;051;255;119m$@\\033[0;00m |\n|  5 | 33FFDD | 170 080 100 | 051 255 221 | \\033[38;2;051;255;221m$@\\033[0;00m |\n|  6 | 33BBFF | 200 080 100 | 051 187 255 | \\033[38;2;051;187;255m$@\\033[0;00m |\n+----+--------+-------------+-------------+------------------------------------+\n```\n\n#### Hex, RGB, HSV\n\nEach of these output options provide all colors in a single comma-delimited line; e.g:\n\n```bash\n# tcolors -p -o hex\n141414, FF7733, FFDD33, C8FF59, 55FF33, 33FF77, 33FFDD, 33BBFF\n```\n\n#### Term\n\nThe `term` output option provides a series of named functions for easy importing and terminal use\n```bash\n# tcolors -p -o term\n_colorbg() { echo -ne \"\\033[38;2;020;020;020m$@\\033[0;00m\"; }\n_color0() { echo -ne \"\\033[38;2;255;119;051m$@\\033[0;00m\"; }\n_color1() { echo -ne \"\\033[38;2;255;221;051m$@\\033[0;00m\"; }\n_color2() { echo -ne \"\\033[38;2;200;255;089m$@\\033[0;00m\"; }\n_color3() { echo -ne \"\\033[38;2;085;255;051m$@\\033[0;00m\"; }\n_color4() { echo -ne \"\\033[38;2;051;255;119m$@\\033[0;00m\"; }\n_color5() { echo -ne \"\\033[38;2;051;255;221m$@\\033[0;00m\"; }\n_color6() { echo -ne \"\\033[38;2;051;187;255m$@\\033[0;00m\"; }\n```\n\nSourcing:\n```bash\nsource \u003c(tcolors -p -o term)\necho \"my $(_color2 what) a $(_color4 bright) $(_color6 day)\"\n```\n\n### Options\n\nOption | Description\n--- | ---\n-f | specify palette file to load/save changes to\n-p | output current palette contents\n-o | color format to output (hex, rgb, hsv, term, all) (default \"all\")\n-v | print version info\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcicen%2Ftcolors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcicen%2Ftcolors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcicen%2Ftcolors/lists"}