{"id":19607014,"url":"https://github.com/codemedic/go-chimer","last_synced_at":"2026-05-04T08:44:07.952Z","repository":{"id":60396006,"uuid":"542842769","full_name":"codemedic/go-chimer","owner":"codemedic","description":"A chiming clock for the command line, written in Go.","archived":false,"fork":false,"pushed_at":"2022-09-30T09:22:25.000Z","size":839,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-06T00:27:00.298Z","etag":null,"topics":["chimer","chimes","clock","command-line-tool","golang","linux","windows"],"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/codemedic.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}},"created_at":"2022-09-29T00:11:41.000Z","updated_at":"2023-03-08T13:07:00.000Z","dependencies_parsed_at":"2023-01-19T00:45:38.952Z","dependency_job_id":null,"html_url":"https://github.com/codemedic/go-chimer","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/codemedic/go-chimer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemedic%2Fgo-chimer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemedic%2Fgo-chimer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemedic%2Fgo-chimer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemedic%2Fgo-chimer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codemedic","download_url":"https://codeload.github.com/codemedic/go-chimer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codemedic%2Fgo-chimer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32600967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"online","status_checked_at":"2026-05-04T02:00:06.625Z","response_time":58,"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":["chimer","chimes","clock","command-line-tool","golang","linux","windows"],"created_at":"2024-11-11T10:08:23.018Z","updated_at":"2026-05-04T08:44:07.917Z","avatar_url":"https://github.com/codemedic.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chimer\n\nA chiming clock for the command line, written in Go.\n\n\n## Installation\n\nYou can install `chimer` either from the latest release archive or be compiled locally.\n\n### From Release Archive\n\n1. Download the latest archive, specific to your platform, from https://github.com/codemedic/go-chimer/releases/latest\n2. Verify SHA256\n3. Extract the archive; e.g. into `~/apps/chimer`\n4. That's it!\n\n### Compile\n\n1. Clone the repo\n   ```\n   git clone https://github.com/codemedic/go-chimer.git\n   ```\n2. Build the binary\n   ```shell\n   # On Linux, dependencies for oto library need to be installed\n   sudo apt install -y libasound2-dev build-essential\n\n   cd go-chimer\n   CGO_ENABLED=1 go build ./cmd/chimer/ \n   ```\n3. Copy binary and sounds\n   ```shell\n   mkdir -p ~/apps/chimer\n   cp -r chimer chimes ~/apps/chimer\n   ```\n\n## Usage\n\nThe `chimer` can be used either as a one-shot command run from a cron, every 15 minutes\nor as a continuously running service, from your service manager of choice. You may also\nrun the binary directly from a terminal window.\n\n### Cron Usage\n\nYou need to add the below line to your `crontab`.\n\n```\n*/15 * * * * /home/username/apps/chimer/chimer --sound /home/username/apps/chimer/chimes` --cron\n```\n\n### From a Terminal Window\n\nRun the command below from a terminal window; make sure you leave the window open afterwards. You may press `Ctrl+C` to stop `chimer`.\n\n```shell\n~/apps/chimer/chimer --sound ~/apps/chimer/chimes\n```\n\nAlternatively, you may add the below line to your `.bashrc` or your shell's rc file to simplify the invocation.\n\n```shell\nexport CHIMER_SOUND_DEFAULT=\"$HOME/apps/chimer/chimes\"\n```\n\nThen `chimer` can be invoked with no commandline option.\n\n```shell\n~/apps/chimer/chimer\n```\n\n## Usage Help\n\nYou can see the below usage help by using the command line option `--help`.\n\n    $\u003e ~/apps/chimer/chimer --help\n    Usage: chimer [options] [arguments]\n\n    OPTIONS\n    --sound/$CHIMER_SOUND_DEFAULT  \u003cstring\u003e\n    Default path for sound(s) if none are not specified.\n    --sound-hour/$CHIMER_SOUND_HOUR  \u003cstring\u003e\n    Path for sound(s) at zero past an hour.\n    --sound-quarter-past/$CHIMER_SOUND_QUARTER_PAST  \u003cstring\u003e\n    Path for sound(s) at quarter past an hour.\n    --sound-half-past/$CHIMER_SOUND_HALF_PAST  \u003cstring\u003e\n    Path for sound(s) at half past an hour.\n    --sound-quarter-to/$CHIMER_SOUND_QUARTER_TO  \u003cstring\u003e\n    Path for sound(s) at quarter to an hour.\n    --cache-sounds/$CHIMER_CACHE_SOUNDS  \u003cbool\u003e  (default: true)\n    Cache sounds in memory\n    --repeat-hourly-sound/-r/$CHIMER_REPEAT_HOURLY_SOUND  \u003cbool\u003e  (default: false)\n    Repeat the hourly sound T time at T'O clock.\n    --minimum-volume-level/-l/$CHIMER_MINIMUM_VOLUME_LEVEL  \u003cint\u003e    (default: 50)\n    --test-time/$CHIMER_TEST_TIME                           \u003cvalue\u003e\n    Specify a time to test chimer in cron-mode. This option is ignored when cron-mode is not enabled.\n    --cron/-c/$CHIMER_CRON_MODE_ENABLED  \u003cbool\u003e  (default: false)\n    Enable cron-mode where it acts on the current time to decide whether to chime or not\n    --help/-h\n    display this help message\n    --version/-v\n    display version information\n\n    NOTE: All sound paths can be either a relative or full path to an MP3 file or\n    a directory containing multiple MP3s. In the latter case, one of the files will\n    be chosen at random for each chime.\n\n## Known Issues\n\n* Chime can go unnoticed when other applications are playing audio.\n* If another app is playing audio but the speaker is muted, chime can unmute and play sound at the set volume level.\n\n## TODO\n\n- [ ] Option to pause media during a chime\n- [ ] Option to mute other apps during a chime\n- [ ] Explore desktop notification instead of / along with a chime\n- [ ] Option to mute chimes between certain hours\n- [ ] Option to change volume level between certain hours\n- [ ] Configuration file\n- [ ] Linux distro / Windows / macOS friendly packages\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemedic%2Fgo-chimer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodemedic%2Fgo-chimer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodemedic%2Fgo-chimer/lists"}