{"id":23385542,"url":"https://github.com/souravgoswami/termclock","last_synced_at":"2025-04-11T03:43:24.205Z","repository":{"id":48943541,"uuid":"329028954","full_name":"Souravgoswami/termclock","owner":"Souravgoswami","description":"A clock for Linux VTE","archived":false,"fork":false,"pushed_at":"2021-07-07T20:56:12.000Z","size":2658,"stargazers_count":22,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T01:44:08.064Z","etag":null,"topics":["clock","linux","rubygem","term-clock","terminal-app","terminal-based"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/Souravgoswami.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-12T15:26:31.000Z","updated_at":"2025-01-29T00:22:02.000Z","dependencies_parsed_at":"2022-09-13T18:13:27.556Z","dependency_job_id":null,"html_url":"https://github.com/Souravgoswami/termclock","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Souravgoswami%2Ftermclock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Souravgoswami%2Ftermclock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Souravgoswami%2Ftermclock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Souravgoswami%2Ftermclock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Souravgoswami","download_url":"https://codeload.github.com/Souravgoswami/termclock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248339288,"owners_count":21087213,"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":["clock","linux","rubygem","term-clock","terminal-app","terminal-based"],"created_at":"2024-12-22T00:19:19.941Z","updated_at":"2025-04-11T03:43:24.179Z","avatar_url":"https://github.com/Souravgoswami.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Termclock\nA clock that runs on the LinuxTerminal!\n\n![Preview](https://github.com/Souravgoswami/termclock/blob/master/previews/preview.gif)\n\n[ Command used: `termclock -af -b -c=\"f55,05f,f80,09e\" -tc=\"55f,f09\"` ]\n\nThis project is a Ruby gem, a continuation of my previous project [term-clock](https://github.com/Souravgoswami/term-clock).\n\nTermClock isn't just a clock, it also shows various information about the system as well.\n\n## Dependencies\nThis program depends on Ruby, and Rubygem. It also has dependency of LinuxStat.\nTo install the whole gem, you need these packages:\n\n1. A Linux Virtual Terminal Emulator (not TTYs)\n2. Noto Fonts Emoji or Fonts Noto Color Emoji\n3. GCC\n4. Make\n\nOn ArchLinux, you can install all of them simply:\n\n```\n# pacman -S ruby gcc make noto-fonts-emoji\n```\n\nOn Ubuntu, LinuxMint, Kali Linux, Debian and other Debian based distributions\nhowever, you also need ruby-dev package once, as a build-time dependency of LinuxStat,\nyou can uninstall it (ruby-dev) once the program is built:\n\n```\n# apt install ruby ruby-dev gcc make fonts-noto-color-emoji\n```\n\nIn both cases, gcc and make are buildtime dependency and you can remove them\nonce the program is built.\n\n## Installation\nTo install this gem, run:\n\n```\n$ gem install termclock\n```\n\n## Usage\n### To run termclock, open the terminal and type:\n\n```\n$ termclock\n```\n\n### Termclock also accepts arguments.\nHere are list of all the arguments:\n```\n1. Help and Version:\n\t--help|-h\t\t\tShows this help section\n\t--version|-v\t\t\tShows termclock version\n\n2. Style:\n\t--bold|-b\t\t\tMake texts bold\n\t--italic|-i\t\t\tMake texts italic\n\t--character=|char=\t\tDraws specified character\n\t--clean\t\t\t\tJust run the clean bare clock\n\t--colour=|-c=\t\t\tSpecify hex colour (4 colours)\n\t--text-colour=|-tc=\t\tSpecify text colour (2 colours)\n\n\t⬢ Colours has to be hex, 3 or 6 characters with or\n\twithout the leading # in front\n\n3. Information:\n\t--no-date|-nd\t\t\tShows no date\n\t--no-message|-nm\t\tShows no messages\n\t--no-sysinfo|-ni\t\tShows no system info\n\t--refresh=|r=\t\t\tSpecify delay or refresh time\n\t--no-logo|-nl\t\t\tDon't show the logo at the bottom\n\n4. Antiflicker:\n\t--antiflicker|-af\t\tDon't flicker terminal\n\n\t⬢ If refresh time is low or terminal is slow, use this option\n\n5. Formats:\n\t--date-format=|-df=\t\tSpecify the date format\n\t--time-format=|-tf=\t\tSpecify the time format\n\n\tUsually the format looks like this:\n\t%H:%M:%S:%2N or %d %B, %Y\n\n\t⬢ Run `date --help` to know more formats\n\nSupported characters are 0 - 9, a - z, /, \\, !, %, and |.\n\n🕑 This is Termclock v0.5.0\n```\n\nRun termclock `--help` or termclock `-h` to see the help.\n\n#### Here are some basic examples:\n+ You can specify the colours:\n\n```\n$ termclock --colour=f55,55f,55f,eee\n# Or\n$ termclock -c=f55,55f,55f,eee\n```\n\n+ You can also change the default characters:\n\n```\n$ termclock -char=\"⬢\"\n# Or\n$ termclock --character=\"⬢\"\n```\n\nA basic example is:\nYou can pass multiple characters, which will be shown in the termclock.\n\n```\n$ termclock -char=\"☺ ☹ \"\n# Or\n$ termclock -char=\"꧁ ꧂ \"\n```\n\nThe 2nd one looks like:\n\n![Preview](https://github.com/Souravgoswami/termclock/blob/master/previews/preview2.jpg)\n\n+ To change the default message (text) colour:\n\n```\ntermclock --text-colour=fa0,55f\n# Or\ntermclock -tc=fa0,55f\n```\n\n### Colours\nThe colours termclock accept are hex colours. You can have either of these formats:\n1. #ff5555\n2. #ff5\n3. ff5555\n4. ff5\n\nUsing either #3eb or 3eb is equivalent to #33eebb.\nUsing either #3ce3b5 is same as 3ce3b5 (no #).\n\nNote that any characters upto 3 bytes work. An emoji can break term clock's look.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/Souravgoswami/termclock.\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsouravgoswami%2Ftermclock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsouravgoswami%2Ftermclock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsouravgoswami%2Ftermclock/lists"}