{"id":49077508,"url":"https://github.com/teegre/bigtime","last_synced_at":"2026-04-20T10:34:32.017Z","repository":{"id":109846526,"uuid":"273347934","full_name":"teegre/bigtime","owner":"teegre","description":"Customizable clock for the terminal, written in bash","archived":false,"fork":false,"pushed_at":"2024-02-02T19:37:15.000Z","size":611,"stargazers_count":21,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-02-03T10:42:30.448Z","etag":null,"topics":["alarm","bash","clock","colorful","customizable","digital","linux","terminal","timer"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/teegre.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2020-06-18T21:58:24.000Z","updated_at":"2024-02-03T10:42:30.448Z","dependencies_parsed_at":"2023-03-13T14:03:12.935Z","dependency_job_id":null,"html_url":"https://github.com/teegre/bigtime","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/teegre/bigtime","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fbigtime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fbigtime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fbigtime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fbigtime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teegre","download_url":"https://codeload.github.com/teegre/bigtime/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fbigtime/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T10:33:29.490Z","status":"ssl_error","status_checked_at":"2026-04-20T10:32:30.107Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["alarm","bash","clock","colorful","customizable","digital","linux","terminal","timer"],"created_at":"2026-04-20T10:34:28.845Z","updated_at":"2026-04-20T10:34:32.006Z","avatar_url":"https://github.com/teegre.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ***-B!GT!ME-***\n\n![screenshot](img/screenshot.png)\n\n**bigtime** is a customizable clock for the terminal, written in bash.\n\n*depends on: bash, coreutils, libpulse, libnotify, ncurses*\n\nTested on these terminals:  \nst, xterm, urxvt, sakura and alacritty (font used: TerminessTTF Nerd Font Mono).\n\n# Table of Contents\n\n* [INSPIRATION](#inspiration)\n* [EXAMPLES](#examples)\n* [INSTALLATION](#installation)\n* [USAGE](#usage)\n* [KEY BINDINGS](#key-bindings)\n* [ALARM](#alarm)\n* [TIMER](#timer)\n* [TIMEZONE](#timezone)\n* [DIGITS FILE](#digits-file)\n* [UNINSTALL](#uninstall)\n* [CREDITS](#credits)\n\n# INSPIRATION \u003ca name=\"inspiration\"\u003e\u003c/a\u003e\n\n## The Concept\n![watch](img/watch.jpg)\n## The Sound\n![gameboy](img/gameboy.jpg)\n## The Colors\n![nyancat](img/nyancat.jpg)\n## The Name\n[Peter Gabriel: Big Time](https://youtube.com/watch?v=PBAl9cchQac)\n\n# EXAMPLES \u003ca name=\"examples\"\u003e\u003c/a\u003e\n\nHere are some examples along with their associated commands\n\n## STANDARD\n![standard](img/standard.png)\n\n`bigtime`\n\n## SIMPLE\n![screencast](img/bigtime.gif)\n\n`bigtime --file simple --big-seconds --rainbow`\n\n## BASIC\n![basic](img/basic.png)\n\n`bigtime --file basic --random`\n\n## BLOCK\n\n![block](img/block.png)\n\n`bigtime --file block`\n\n## DIGITAL\n\n![digital](img/digital.png)\n\n`bigtime --file digital --date -f --rainbow --small-seconds --vertical`\n\n## BLOCK2\n\n![block2](img/block2.png)\n\n`bigtime --file block2 --foreground 125`\n\n## FLIP\n\n![flip](img/flip.png)\n\n`bigtime -S --file flip --foreground 214`\n\n![flipv](img/flipv.png)\n\n`bigtime -nSv --file flip`\n\n# INSTALLATION \u003ca name=\"installation\"\u003e\u003c/a\u003e\n\nYou can find **bigtime** in the [Arch User Repository](https://aur.archlinux.org/packages/bigtime).\n\n## Clone this repository:\n\n`git clone https://github.com/teegre/bigtime.git`\n\n## Install **bigtime**\n\n`make install`\n\n# USAGE \u003ca name=\"usage\"\u003e\u003c/a\u003e\n\nbigtime [OPTION [VALUE] ... OPTION [VALUE]]\n\nOPTIONS:\n\n* -s, --small-seconds      - show seconds (normal size).\n* -S, --big-seconds        - show seconds (big size).\n* -d, --date               - show date.\n* -f                       - display time in 24h format.\n* -z, --timezone           - show timezone (i.e. +0200).\n* -F, --foreground 0..N    - set foreground color.\n* -B, --background 0..N    - set background color.\n* -r, --rainbow            - rainbow effect (override -n and -F options).\n* -n, --random             - random colors effect (override -r and -F options).\n* -C, --list-colors        - print available colors and exit.\n* -b, --blink              - blinking separators.\n* -N, --no-separator       - do not display separators (horizontal layout only).\n* -a, --alarm TIME         - set daily alarm (TIME format: [H]H:MM[AM|am|PM|pm])\n* -t, --timer DURATION     - set timer (DURATION format: [H]H:MM).\n* -i, --signal             - activate hourly time signal.\n* -v, --vertical           - display clock vertically.\n* --file FILENAME          - use a custom **digits file** (filename only).\n* -w, --preview            - (with --file) display a preview of the selected file and exit.\n* -l, --list-files         - print available **digits files** and exit.\n* -e, --edit FILENAME      - create and/or edit a custom **digits file** (filename only).\n* -q, --quiet              - disable sound, alarm, timer and hourly time signal.\n* -h, --help               - print this help message and exit.\n* -V, --version            - print program's version and exit.\n\n# INDICATORS\nIndicator are displayed on the left hand side of the clock:\n\n* `*`   - hourly time signal activated.\n* `a`   - daily alarm activated.\n* `t`   - timer activated.\n* `\u003ea`  - alarm display mode.\n* `a\u003e`  - alarm setting mode.\n* `a`   - alarm is ringing (blinking).\n* `z`   - alarm snooze mode.\n* `\u003et`  - timer display mode.\n* `t\u003e`  - timer setting mode.\n* `t`  - timer is ringing (blinking).\n\nThese are the default indicators but they can be changed (see [DIGITS FILE](#digits-file) section).\n\n# KEY BINDINGS \u003ca name=\"key-bindings\"\u003e\u003c/a\u003e\n\n* \u003ckbd\u003ea\u003c/kbd\u003e     - toggle daily alarm; set/confirm new alarm; disable **snooze** mode.\n* \u003ckbd\u003ef\u003c/kbd\u003e     - toggle 24h format; toggle AM/PM (alarm setting mode).\n* \u003ckbd\u003ei\u003c/kbd\u003e     - toggle hourly time signal.\n* \u003ckbd\u003ej\u003c/kbd\u003e     - select next digit (setting mode).\n* \u003ckbd\u003ek\u003c/kbd\u003e     - select previous digit (setting mode).\n* \u003ckbd\u003eq\u003c/kbd\u003e     - exit program.\n* \u003ckbd\u003eR\u003c/kbd\u003e     - refresh screen.\n* \u003ckbd\u003et\u003c/kbd\u003e     - toggle timer; set/confirm new timer.\n* \u003ckbd\u003espace\u003c/kbd\u003e - toggle display mode; stop; cancel (setting mode).\n\n# ALARM \u003ca name=\"alarm\"\u003e\u003c/a\u003e\n\n## From the command line\n\nTo set a daily alarm starting at 7:00 AM:  \n`bigtime --alarm \"7:00 AM\"`\n\nTo test the alarm (actually don't set an alarm):  \n`bigtime --alarm \"now\"`\n\nPress \u003ckbd\u003espace\u003c/kbd\u003e to stop the alarm.  \n\n## From within the application\n\n```\n                               SET ALARM\n   ∎    ∎∎∎     ∎∎∎   ∎∎∎     ∎∎∎   ∎∎∎  M\n  ∎∎   ∎   ∎   ∎   ∎ ∎   ∎   ∎   ∎ ∎   ∎\n   ∎      ∎    ∎ ∎ ∎ ∎ ∎ ∎   ∎ ∎ ∎  ∎∎∎∎\n   ∎     ∎   ∎ ∎   ∎ ∎   ∎   ∎   ∎    ∎\n  ∎∎∎  ∎∎∎∎∎ ∎  ∎∎∎   ∎∎∎     ∎∎∎    ∎   AM\n 12:52p\n```\n\nPress \u003ckbd\u003ea\u003c/kbd\u003e to set a new alarm.  \nTo modify an existing alarm, press \u003ckbd\u003espace\u003c/kbd\u003e and \u003ckbd\u003ea\u003c/kbd\u003e.  \nEnter the desired time.  \nPress \u003ckbd\u003ej\u003c/kbd\u003e or \u003ckbd\u003ek\u003c/kbd\u003e to select next/previous digit.  \n*The last two digits are snooze duration in minutes (from 5 to 15)*  \n*Note: as opposed to alarm setting, when snooze duration is modified,  \nchanges are applied immediately.*\n\nPress \u003ckbd\u003ef\u003c/kbd\u003e to toggle AM/PM if necessary.\n\nWhen done, press \u003ckbd\u003ea\u003c/kbd\u003e to activate alarm.\n\nOr press \u003ckbd\u003espace\u003c/kbd\u003e to cancel.\n\n# TIMER \u003ca name=\"timer\"\u003e\u003c/a\u003e\n\n## From the command line\n\nTo set a 3 minutes timer:  \n`bigtime --timer 0:03`\n\n## From within the application\n\nPress \u003ckbd\u003et\u003c/kbd\u003e to set a new timer.  \nTo modify an existing timer, press \u003ckbd\u003espace\u003c/kbd\u003e (twice if an alarm is set) and \u003ckbd\u003et\u003c/kbd\u003e.  \nEnter the desired duration (from 1 minute to 23 hours and 59 minutes).  \nPress \u003ckbd\u003ej\u003c/kbd\u003e or \u003ckbd\u003ek\u003c/kbd\u003e to select next/previous digit.  \n\nWhen done, press \u003ckbd\u003et\u003c/kbd\u003e to confirm.\n\nOr press \u003ckbd\u003espace\u003c/kbd\u003e to cancel.\n\n# TIMEZONE \u003ca name=\"timezone\"\u003e\u003c/a\u003e\n\nTo display the time for a different timezone, i.e.:  \n```TZ=Europe/Paris bigtime```\n\n# DIGITS FILE \u003ca name=\"digits-file\"\u003e\u003c/a\u003e\n\nIn a nutshell, a **digits file** is a text file with the **.digits** extension  \nthat contains instructions on how to draw digits on the screen.\n\nDigits are sequences of 0s and 1s and are defined as semicolon separated lists.  \n**Bigtime** needs some clue about digits geometry (height and width in characters).\n\nSome other *optional* parameters are available, like layout, colors and indicators.  \nIf these parameters are omitted or left blank, default values are used or values  \nspecified via the command line options.\n\n## GEOMETRY\n\n* height=*integer*    - height of a digit, in characters. **[mandatory]**\n* width=*integer*     - width of a digit, in characters.  **[mandatory]**\n* sep_width=*integer* - width of a separator, in characters. **[optional]**\n\n### Example:\n\n```\nheight=5\nwidth=5\nsep_width=3\n```\n\n## LAYOUT\n\n* layout=*horizontal*|*vertical*\n\nThe **layout** optional parameter can be used to force the clock to display in a particular layout.\n\n## COLORS\n\n* colors=*list*|*rainbow*|*random*\n* background=*integer*\n* foreground=*integer*\n\n**colors** parameter can be either a semicolon separated list of 11 colors (so that every digit/separator is  \nassigned a color), **rainbow** (equivalent of **--rainbow**), or **random** (equivalent of **--random**).\n\nInteger value is a color number as shown by **--list-colors** option.\n\n*Note:* **colors command line options supersede** these parameters.\n\n## SECONDS\n\n* seconds=*big*|*small*\n\nEquivalent to **--big-seconds** and **--small-seconds** options.\n\n## INDICATORS\n\n* am_indicator=*string*\n* pm_indicator=*string*\n* signal_indicator=*char*\n* alarm_indicator=*char*\n* snooze_indicator=*char*\n* timer_indicator=*char*\n\n## DIGITS\n\n* 0-9=*list*\n* separator=*list*\n* blank=*list*\n\nAs stated before, a digit is defined by a semicolon separated list.  \nFor example:\n\n```\n0=11111;11011;11011;11011;11111\n...\n9=11111;11011;11111;00011;11111\nseparator=000;010;000;010;000\nblank=000;000;000;000;000\n```\n\n## FILLED SPACE, EMPTY SPACE\n\n* char=char  - character to display as filled space (1).\n* space=char - character to display as empty space (0).\n\nBy default, when **bigtime** parses a file, 0s are replaced with whitespaces and 1s with \"∎\".  \nBut one can define characters as shown below:\n\n```\nchar=@\nspace=-\n```\n\nGiven the characters defined earlier, this (0):\n\n```\n11111\n11011\n11011\n11011\n11111\n```\n\nBecomes this:\n\n```\n@@@@@\n@@-@@\n@@-@@\n@@-@@\n@@@@@\n```\n\nSo far, so good...  \n\n## MAKE YOUR OWN DIGITS FILE\n\nYou can find more examples in \"/etc/bigtime/digits\" directory\n\nCustom **digits files** must be stored in **bigtime** configuration directory:  \n`$HOME/.config/bigtime`\n\nYou can use the **--edit** option to create a new file from a template and edit it.  \n\n**Note**: Whenever **bigtime** encounters a mistake in a **digits file**,  \nit will throw an error and a useful description.\n\n# UNINSTALL \u003ca name=\"uninstall\"\u003e\u003c/a\u003e\n\nAre you sure?\n\n`make uninstall`\n\n# CREDITS \u003ca name=\"credits\"\u003e\u003c/a\u003e\n\n* Sound effects made with the excellent [sfxr](http://www.drpetter.se/project_sfxr.html)\n* Icons for notifications are taken from [Material Design Icons](https://materialdesignicons.com/)\n* Last but not least: [Pure Bash Bible](https://github.com/dylanaraps/pure-bash-bible)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fbigtime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteegre%2Fbigtime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fbigtime/lists"}