{"id":19256536,"url":"https://github.com/kj-sh604/datetimesetter","last_synced_at":"2026-05-16T00:07:00.478Z","repository":{"id":251174536,"uuid":"836582577","full_name":"kj-sh604/dateTimeSetter","owner":"kj-sh604","description":"Functional GUI for systemd's \"timedatectl\" written in python \u0026 tk. Useful for standalone window managers on Linux.","archived":false,"fork":false,"pushed_at":"2024-08-01T07:20:59.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-05T08:53:33.665Z","etag":null,"topics":["cython","gnu","gnu-linux","linux","python","systemd","timedatectl","tk","tkinter","tkinter-gui"],"latest_commit_sha":null,"homepage":"https://aedrielkylejavier.me/scripts-and-tools/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kj-sh604.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-01T06:43:10.000Z","updated_at":"2024-08-04T03:31:07.000Z","dependencies_parsed_at":"2024-08-01T09:56:08.863Z","dependency_job_id":null,"html_url":"https://github.com/kj-sh604/dateTimeSetter","commit_stats":null,"previous_names":["kj-sh604/datetimesetter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kj-sh604%2FdateTimeSetter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kj-sh604%2FdateTimeSetter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kj-sh604%2FdateTimeSetter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kj-sh604%2FdateTimeSetter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kj-sh604","download_url":"https://codeload.github.com/kj-sh604/dateTimeSetter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240356096,"owners_count":19788512,"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":["cython","gnu","gnu-linux","linux","python","systemd","timedatectl","tk","tkinter","tkinter-gui"],"created_at":"2024-11-09T19:06:05.428Z","updated_at":"2026-05-16T00:07:00.472Z","avatar_url":"https://github.com/kj-sh604.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dateTimeSetter ⌚\n\n*Easily Adjust Date \u0026 Time in Standalone Window Managers*\n\n![Image of dateTimeSetter](https://aedrielkylejavier.me/programs-and-scripts/img/dateTimeSetter-tk.png)\n\n## Rationale\n\nI use a standalone Window Manager on Linux (no Desktop Environment) and I missed having a simple GUI to quickly change Timezones and toggle NTP in a settings panel, which is commonly found in Desktop Environments. To address this, I made `dateTimeSetter`, a simple \"date \u0026 time setter\" written in Python and Tk.\n\n## Features\n\n* Simple as possible, so that it just gets out of your way and you can proceed with your life.\n* Can manipulate the following through the interface:\n    * Date\n    * Time\n    * Timezone\n    * Local RTC setting\n    * NTP\n* Automatically sets the Date, Time, and Timezone with a checkbox.\n* `Makefile` \n    * I've also included a Makefile that utilizes `cython3` to create a `.c` file from the `.py` code and then compile with `gcc` into a single binary.\n    * I can't really vouch for the continued reliability of the `Makefile` nor can I promise a significant performance increase with it being compiled as C code, but it's there if you want to give it a go 😌. \n    * You will need to have `cython`, `gcc`, and `make` installed on your system (on top of the dependencies listed below) to utilize the `Makefile`.\n\n\n## Dependencies\n\nTo use `dateTimeSetter`, you will need to install the following dependencies. Here are some instructions on how to install them on various Linux distributions:\n\n### Ubuntu / Debian\n```sh\nsudo apt update\nsudo apt install python3-tk python3-pip\npip3 install pytz requests\n```\n\n### Fedora\n```sh\nsudo dnf install python3-tkinter python3-pip\npip3 install pytz requests\n```\n\n### Arch Linux\n```sh\nsudo pacman -S tk python-pip python-pytz python-requests\n```\n\n## Usage\n\n```sh\n$ python3 ./dateTimeSetter.py\n```\n\nor simply…\n\n```sh\n$ ./dateTimeSetter.py\n```\n\n### How I Like to Run it On My Machines\n\nAs seen on my [dotfiles repo](https://github.com/kj-sh604/dotfiles), I wrap the usage of `dateTimeSetter` in a script:\n\n*I have it named as* `dateTime` *on my system*\n\n```sh\n#!/bin/sh\n\nBIN_PATH=~/.local/share/python-dateTimeSetter/dateTime\nSCRIPT_PATH=~/.local/share/python-dateTimeSetter/dateTime.py\n\nif [ -f \"$BIN_PATH\" ]; then\n    if command -v lxsudo \u003e /dev/null 2\u003e\u00261; then\n        lxsudo $BIN_PATH\n    elif command -v gksudo \u003e /dev/null 2\u003e\u00261; then\n        gksudo $BIN_PATH\n    elif command -v pkexec \u003e /dev/null 2\u003e\u00261; then\n        pkexec env DISPLAY=\"$DISPLAY\" XAUTHORITY=\"$XAUTHORITY\" $BIN_PATH\n    else\n        echo \"No suitable graphical authentication tool found. Running without root privileges.\"\n        notify-send \"No suitable graphical authentication tool found. Running without root privileges.\"\n        $BIN_PATH\n    fi\nelif [ -f \"$SCRIPT_PATH\" ]; then\n    if command -v lxsudo \u003e /dev/null 2\u003e\u00261; then\n        lxsudo python3 $SCRIPT_PATH\n    elif command -v gksudo \u003e /dev/null 2\u003e\u00261; then\n        gksudo python3 $SCRIPT_PATH\n    elif command -v pkexec \u003e /dev/null 2\u003e\u00261; then\n        pkexec env DISPLAY=\"$DISPLAY\" XAUTHORITY=\"$XAUTHORITY\" python3 $SCRIPT_PATH\n    else\n        echo \"No suitable graphical authentication tool found. Running without root privileges.\"\n        notify-send \"No suitable graphical authentication tool found. Running without root privileges.\"\n        python3 $SCRIPT_PATH\n    fi\nelse\n    echo \"dateTime/dateTime.py not found\"\n    notify-send \"Error!\" \"dateTime/dateTime.py not found\" --urgency critical\nfi\n```\n\nFeel free to implement something similar.\n\n\u0026nbsp;\n\nI hope that some of you would find this useful 😌\n\nHappy hacking everyone! 🧑‍💻🤙\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkj-sh604%2Fdatetimesetter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkj-sh604%2Fdatetimesetter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkj-sh604%2Fdatetimesetter/lists"}