{"id":35252145,"url":"https://github.com/charles-m-knox/frequencmd","last_synced_at":"2026-04-09T04:01:26.987Z","repository":{"id":284705260,"uuid":"854255132","full_name":"charles-m-knox/frequencmd","owner":"charles-m-knox","description":" TUI app that can run any shell commands you want. Like bookmarks in your web browser, except shell commands. ","archived":false,"fork":false,"pushed_at":"2025-04-15T02:40:31.000Z","size":145,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T03:32:20.606Z","etag":null,"topics":["bash","bookmarks","frequent","frequent-commands","go","golang","shell","terminal","tui","tview","utility"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/charles-m-knox.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,"zenodo":null}},"created_at":"2024-09-08T19:25:29.000Z","updated_at":"2025-04-15T02:40:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"9a0244b7-d987-4762-9165-8dd03909755c","html_url":"https://github.com/charles-m-knox/frequencmd","commit_stats":null,"previous_names":["charles-m-knox/frequencmd"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/charles-m-knox/frequencmd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charles-m-knox%2Ffrequencmd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charles-m-knox%2Ffrequencmd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charles-m-knox%2Ffrequencmd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charles-m-knox%2Ffrequencmd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/charles-m-knox","download_url":"https://codeload.github.com/charles-m-knox/frequencmd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charles-m-knox%2Ffrequencmd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31584816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"online","status_checked_at":"2026-04-09T02:00:06.848Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bash","bookmarks","frequent","frequent-commands","go","golang","shell","terminal","tui","tview","utility"],"created_at":"2025-12-30T06:58:19.604Z","updated_at":"2026-04-09T04:01:26.982Z","avatar_url":"https://github.com/charles-m-knox.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# frequencmd\n\nTUI app that can run any shell commands you want. Like bookmarks in your web browser, except shell commands.\n\n## Screenshots\n\n![A screenshot of frequencmd running in a small terminal in the st terminal emulator inside the Awesome Window Manager running on x11](./screenshots/frequencmd.png)\n\n![A larger screenshot of frequencmd running in a terminal in the st terminal emulator inside the Awesome Window Manager running on x11](./screenshots/frequencmd-lg.png)\n\n## Motivation\n\nI run a lot of commands frequently and wanted to have an easy way to run them. They're not complex - they'll do things like setting the current screen brightness, or change the current powersaver mode. A TUI-based application that could do this for me proved very useful, as it could be used regardless of whether I have an x11/wayland display server running or if I'm in a tty.\n\n## Features\n\n- `/` key to fuzzy find items in the left pane (`/` key again to clear search)\n- multiple commands can be run simultaneously\n- stderr and stdout are separated\n- everything else should be intuitive \u0026 simple\n\n## Disclaimer\n\nThis application may be buggy. It is not battle-tested except for within my own use cases, which have been successful for about a month as of writing this. It may not do what you expect. You've been warned!\n\n## Usage\n\nDownload the appropriate version from the releases page according to your OS. Note that not all systems have been tested at this point in time.\n\n**Important: Mac users need to un `unxz frequencmd-*.xz` first.** Builds for Macs are compressed using `xz` because the build process uses `upx` to compress binaries for all platforms, which does not support Mac OS.\n\nThen, copy `config.example.yml` to `~/.config/frequencmd/config.yml` and modify it to your needs. You may need to create the parent directory.\n\n## Building locally\n\nRequires Go. It is a very lean application and should be easy to get running. You can install it via `go install`:\n\n```bash\nCGO_ENABLED=0 go install -ldflags=\"-s -w\" github.com/charles-m-knox/frequencmd@latest\n```\n\nJust make sure you have configured your `$PATH` environment variable to include your go bin directory.\n\n## Configuration\n\nThe application will first attempt to read from the first file it finds at the following locations:\n\n1. `./config.yml`, then\n2. `$XDG_CONFIG_HOME/frequencmd/config.yml`, then\n3. `$HOME/frequencmd/config.yml`.\n\nThe configuration is a simple `yml` file and currently looks like:\n\n```yaml\n---\nidleRefreshRateMs: 500\nprocessRunningRefreshRateMs: 100\n\ncommands:\n  - label: \"2200K\"\n    command: \"redshift\"\n    args: \"-P -O 2200\"\n    env:\n      - \"DISPLAY=:0\"\n\n  - label: \"4800K\"\n    command: \"redshift\"\n    args: \"-P -O 4800\"\n    env:\n      - \"DISPLAY=:0\"\n\n  - label: \"6500K\"\n    command: \"redshift\"\n    args: \"-P -O 6500\"\n    env:\n      - \"DISPLAY=:0\"\n\n  - label: \"brightness 100%\"\n    command: \"/bin/bash\"\n    shell: \"xrandr --output eDP-1 --brightness 1\"\n    env:\n      - \"DISPLAY=:0\"\n\n# ...\n```\n\n## Roadmap\n\nThere's not much left to do on this application aside from polishing and refactoring to clean up the codebase. It was hacked together pretty quickly and really doesn't need to do anything more than what it already does. However, it would be neat to have configurable colors translation strings, but currently I'm making no public commitment to that end.\n\n## Compilation targets\n\nRun `make build-all` to build for Linux amd64 \u0026 arm, Mac amd64 \u0026 arm, and Windows amd64 at the same time. It may take a short while to build for all platform targets. The `xz` command used may require ~14GB of RAM - to change this, modify the `xz -9` flag in `Makefile` to something like `-6`, or just get rid of the extra performance flags entirely.\n\n## License\n\nThis software is licensed as AGPL3 or later, see [`LICENSE`](/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharles-m-knox%2Ffrequencmd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharles-m-knox%2Ffrequencmd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharles-m-knox%2Ffrequencmd/lists"}