{"id":44134165,"url":"https://github.com/arthur-dnts/clocktemp","last_synced_at":"2026-02-08T23:00:43.541Z","repository":{"id":284803208,"uuid":"956112390","full_name":"arthur-dnts/ClockTemp","owner":"arthur-dnts","description":"A TUI clock that displays time, date, temperature and more.","archived":false,"fork":false,"pushed_at":"2026-02-05T11:44:29.000Z","size":513,"stargazers_count":90,"open_issues_count":1,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-05T21:48:17.109Z","etag":null,"topics":["calendar","clock","stopwatch","timer","tui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arthur-dnts.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-27T18:05:54.000Z","updated_at":"2026-02-05T11:39:06.000Z","dependencies_parsed_at":"2026-02-05T12:15:51.443Z","dependency_job_id":null,"html_url":"https://github.com/arthur-dnts/ClockTemp","commit_stats":null,"previous_names":["dantas-arthur/clocktemp"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/arthur-dnts/ClockTemp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthur-dnts%2FClockTemp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthur-dnts%2FClockTemp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthur-dnts%2FClockTemp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthur-dnts%2FClockTemp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arthur-dnts","download_url":"https://codeload.github.com/arthur-dnts/ClockTemp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arthur-dnts%2FClockTemp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29248487,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T22:49:53.206Z","status":"ssl_error","status_checked_at":"2026-02-08T22:49:51.384Z","response_time":57,"last_error":"SSL_read: 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":["calendar","clock","stopwatch","timer","tui"],"created_at":"2026-02-08T23:00:20.269Z","updated_at":"2026-02-08T23:00:43.535Z","avatar_url":"https://github.com/arthur-dnts.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n \u003cimg src=\"assets/logo.png\"\u003e\n \u003cp\u003e\u003cb\u003eClockTemp\u003c/b\u003e is a TUI clock inspired by \u003ca href=\"https://github.com/xorg62/tty-clock\"\u003etty-clock\u003c/a\u003e that displays the time, date, temperature and more.\u003c/p\u003e\u003cbr\u003e\n \u003ca href=\"https://github.com/arthur-dnts/ClockTemp/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/arthur-dnts/ClockTemp?\u0026style=for-the-badge\u0026color=F2F4F8\u0026labelColor=161616\"\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/arthur-dnts/ClockTemp/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/arthur-dnts/ClockTemp?\u0026style=for-the-badge\u0026color=F2F4F8\u0026labelColor=161616\"\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/arthur-dnts/ClockTemp/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/arthur-dnts/ClockTemp?style=for-the-badge\u0026color=F2F4F8\u0026labelColor=161616\u0026label=Version\"\u003e\u003c/a\u003e\n \u003cimg src=\"https://img.shields.io/github/last-commit/arthur-dnts/ClockTemp?\u0026style=for-the-badge\u0026color=F2F4F8\u0026labelColor=161616\"\u003e\n \u003cimg src=\"https://img.shields.io/badge/-Linux-161616?style=for-the-badge\u0026logo=linux\u0026color=F2F4F8\u0026labelColor=161616\u0026logoColor=F2F4F8\"\u003e\n \u003cimg src=\"assets/Screenshot.png\"\u003e\n \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e • \u003ca href=\"#remove-clocktemp\"\u003eUninstall\u003c/a\u003e • \u003ca href=\"#commands-and-interactive-keys-list\"\u003eCommands and Keys\u003c/a\u003e • \u003ca href=\"#credits\"\u003eCredits\u003c/a\u003e • \u003ca href=\"#resources-used\"\u003eResources Used\u003c/a\u003e • \u003ca href=\"#contributors\"\u003e Contributors \u003c/a\u003e  \n\u003c/div\u003e\n\n## Installation\n\n\u003e [!IMPORTANT]\nPrerequisites: [Python](https://www.python.org/) version 3.x and [requests](https://pypi.org/project/requests/) library\n\n1. Clone the repository to have local access to all the necessary files. You can do this using the following command:\n ```\n git clone https://github.com/dantas-arthur/ClockTemp.git\n ```\n\n2. On your terminal navigate to the project directory\n  ```\n  cd YOUR/DIRECTORY/ClockTemp/script\n  ```\n3. Run the \u003ccode\u003einstall.sh\u003c/code\u003e file to install ClockTemp into your environment variables\n ```\n sudo ./install.sh\n ```\n4. Now whenever you run the \u003ccode\u003eclocktemp\u003c/code\u003e command in your terminal the script will work\n ```\n clocktemp\n ```\n\n\u003e [!TIP]\nSince ClockTemp has many customization options, you can create an alias in Bashrc / Zshrc to set the desired options once.\n\n1. On your terminal open bashrc / zshrc\n ```\n nano ~/.bashrc # If Bash is your shell\n ```\n\n ```\n nano ~/.zshrc # If ZSH is your shell\n ```\n2. At the end of the file add your custom configuration\n ```\n alias clocktemp='clocktemp -tf YOUR_TIME_FORMAT -df YOUR_DATE_FORMAT -tu YOUR_TEMPERATURE_UNIT -s SHOW_OR_HIDE_SECONDS -lat YOUR_LATITUDE -lon YOUR_LONGITUDE -c YOUR_TEXT_COLOR -b YOUR_BACKGROUND_COLOR'\n ```\n3. Save your changes pressing \u003ccode\u003eCTRL + O\u003c/code\u003e \u003e \u003ccode\u003eENTER\u003c/code\u003e and exit with \u003ccode\u003eCTRL + X\u003c/code\u003e\n\n4. Apply changes on your terminal\n ```\n source ~/.bashrc # If Bash is your shell\n ```\n\n ```\n source ~/.zshrc # If ZSH is your shell\n ```\n5. Now whenever you run the \u003ccode\u003eclocktemp\u003c/code\u003e command without arguments the alias will cause the previously saved settings to be loaded.\n ```\n clocktemp\n ```\n\n## Remove ClockTemp\n\n\u003e [!NOTE]\nIf you want to remove ClockTemp from your environment variables, follow these steps:\n\n1. Run this command to remove the clocktemp folder from local/bin\n ```\n sudo rm /usr/local/bin/clocktemp\n ```\n2. Run this another command to remove the clocktemp folder from local/share\n ```\n sudo rm -r /usr/local/share/clocktemp\n ```\n\n## Commands and Interactive Keys list\n\n| COMMAND | CHOICES | DEFAULT | FUNCTION |\n|:-------:|:-------:|:-------:|:--------:|\n| -h, --help | None | None | Show help message and exit |\n| -v, --version | None | None | Show program's version and exit |\n| -tf     | 12 / 24 |   12    | Change time format between 12-hour and 24-hour |\n| -df     | mm/dd / dd/mm |   mm/dd    | Change date format between MM/DD/YYYY and DD/MM/YYYY |\n| -tu     | c / f |   c    | Change temperature unit between Celsius and Fahrenheit |\n| -bd     | true / false |   false    | Use bold characters |\n| -s      | true / false |   true    | Show or hide seconds |\n| -a      | true / false |   true    | Stop timer/stopwatch after reset |\n| -c      | white / black / red / yellow / green / cyan / blue / magenta |   white    | Change text color |\n| -b      | default / white / black / red / yellow / green / cyan / blue / magenta |   default    | Change background color |\n| -lat    | Any latitude |   0    | Use the user's latitude to get weather data from Open-Meteo API |\n| -lon    | Any longitude |   0    | Use the user's longitude to get weather data from Open-Meteo API |\n\nExample command:\n ```\n clocktemp -tf 24 -df dd/mm -tu c -s true -lat 12.345 -lon -67.891 -c cyan -b default\n ```\n\n|   KEYS   | FUNCTION |\n|:--------:|:--------:|\n| w        | Switch to clock mode |\n| c        | Switch to calendar mode |\n| s        | Switch to stopwatch mode |\n| t        | Switch to timer mode |\n| h        | Switch to help menu |\n| r        | Reset (only in stopwatch or timer modes) |\n| SPACEBAR | Pause/Resume (only in stopwatch or timer modes) |\n| \u003c / ,    | Previous month (only in calendar mode) |\n| \u003e / .    | Next month (only in calendar mode) |\n| q or ESC | Quit program |\n  \n## Credits\n\nThe digit display matrix of \u003ccode\u003eclock.py\u003c/code\u003e archive was adapted from [tty-clock](https://github.com/xorg62/tty-clock), licensed under the BSD-3 Clause:\n\n```\nCopyright (c) 2009-2018 tty-clock contributors\nCopyright (c) 2008-2009 Martin Duquesnoy \u003cxorg62@gmail.com\u003e\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n* Redistributions of source code must retain the above copyright\n  notice, this list of conditions and the following disclaimer.\n* Redistributions in binary form must reproduce the above\n  copyright notice, this list of conditions and the following disclaimer in the\n  documentation and/or other materials provided with the distribution.\n* Neither the name of the tty-clock nor the names of its\n  contributors may be used to endorse or promote products derived from this\n  software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR\nANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\nLOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\nANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\nSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n```\n\n## Resources used\n\nThis project was made using \u003ccode\u003ePython\u003c/code\u003e version 3.10.12, the \u003ccode\u003eRequests\u003c/code\u003e library and \u003ccode\u003eOpen-Meteo\u003c/code\u003e API to collect weather data.\n\n## License\n\nThe \u003ccode\u003eClockTemp\u003c/code\u003e project as a whole is licensed under the GNU General Public License v3 (GPLv3). See the \u003ca href=\"https://github.com/arthur-dnts/ClockTemp/blob/main/LICENSE\"\u003eLICENSE\u003c/a\u003e file for details.\n\n## Contributors\n\n| [\u003cdiv\u003e\u003cimg width=100 src=\"https://avatars.githubusercontent.com/u/73240555?v=4\"\u003e\u003cbr\u003e\u003cspan\u003eArthur D.\u003c/span\u003e\u003c/div\u003e][Arthur D.] | [\u003cdiv\u003e\u003cimg width=100 src=\"https://avatars.githubusercontent.com/u/193435795?v=4\"\u003e\u003cbr\u003e\u003cspan\u003ebinsld\u003c/span\u003e\u003c/div\u003e][Sergeev Lev] |\n|:-------:|:-------:|\n\n## Star History\n\n\u003ca href=\"https://www.star-history.com/#arthur-dnts/ClockTemp\u0026Timeline\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=arthur-dnts/ClockTemp\u0026type=Timeline\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=arthur-dnts/ClockTemp\u0026type=Timeline\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=arthur-dnts/ClockTemp\u0026type=Timeline\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n\u003c!--Contributors--\u003e\n[Arthur D.]: https://github.com/arthur-dnts\n[Sergeev Lev]: https://github.com/binsld\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farthur-dnts%2Fclocktemp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farthur-dnts%2Fclocktemp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farthur-dnts%2Fclocktemp/lists"}