{"id":16674065,"url":"https://github.com/tech189/ab-urbe-condita","last_synced_at":"2025-04-07T12:46:16.010Z","repository":{"id":90146903,"uuid":"191841630","full_name":"tech189/Ab-Urbe-Condita","owner":"tech189","description":"Outputs time and date in Roman dating system","archived":false,"fork":false,"pushed_at":"2022-02-24T16:16:44.000Z","size":61,"stargazers_count":2,"open_issues_count":10,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-02-13T15:36:25.121Z","etag":null,"topics":["classics","clock","latin","python","rainmeter","roman","ubersicht"],"latest_commit_sha":null,"homepage":"","language":"Python","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/tech189.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}},"created_at":"2019-06-13T22:32:17.000Z","updated_at":"2023-01-27T23:41:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"63352d91-6928-40c2-b91d-a9e986d7f8a2","html_url":"https://github.com/tech189/Ab-Urbe-Condita","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/tech189%2FAb-Urbe-Condita","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tech189%2FAb-Urbe-Condita/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tech189%2FAb-Urbe-Condita/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tech189%2FAb-Urbe-Condita/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tech189","download_url":"https://codeload.github.com/tech189/Ab-Urbe-Condita/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247655984,"owners_count":20974273,"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":["classics","clock","latin","python","rainmeter","roman","ubersicht"],"created_at":"2024-10-12T12:29:13.916Z","updated_at":"2025-04-07T12:46:15.997Z","avatar_url":"https://github.com/tech189.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ab Urbe Condita\n\nA small program to convert times and dates into the Roman system.\n\nRun `auc.py` with no arguments to output current date and time or use the following arguments:\n\n```text\n--json          output in JSON for portability\n--simple        only print the Roman format\n--idiomatic     abbreviated dates to be more idiomatic\n--custom        convert a custom date (ISO 8601)\n--debug         print calculations etc. for debugging\n```\n\nFor example:\n\n```text\npython3 auc.py\n    23:27, Thursday, 13 June 2019 AD\n    hora II post solis occasum\n    dies Iovis\n    Idus Junias\n    MMDCCLXXII AUC\n```\n\nTo use a custom date, you must use the ISO 8601 format, for example:\n\n```text\npython3 auc.py --custom 1234-05-06\n    Saturday, 6 May 1234 AD\n    dies Saturni\n    pridie Nonas Majas\n    MCMLXXXVII AUC\n```\n\nTo use the data in other programs, simply use the `--json` argument:\n\n```json\npython3 auc.py --json\n    {\"normal\": {\"time\": \"00:21\", \"day\": \"Thursday\", \"date\": \"17 June\", \"year\": \"2021\"}, \"roman\": {\"time\": \"hora IV ante solis ortum\", \"day\": \"dies Jovis\", \"date\": \"ante diem XV Kalendas Quintiles\", \"idiomatic_date\": \"a.d. XV Kal. Qui.\", \"year\": \"MMDCCLXXIV\"}}\n```\n\nOr, if you're writing in Python, you could `import` it in your program:\n\n```python\n\u003e\u003e\u003e import auc, datetime\n\u003e\u003e\u003e print(\"hodie est \" + auc.get_day(datetime.datetime.now()) + \"!\")\nhodie est dies Jovis!\n```\n\n## Widgets!\n\nThere are desktop widgets for both Windows and macOS - if you're stuck installing them feel free to raise an issue [here](https://github.com/tech189/Ab-Urbe-Condita/issues). For now, updating the widgets is a manual process until I figure out some kind of automatic update checker ([see issue #7](https://github.com/tech189/Ab-Urbe-Condita/issues/7)).\n\n### Rainmeter Widget (Windows)\n\n#### Step by step\n\n1. (Install [Rainmeter](https://www.rainmeter.net/) and open it at least once)\n2. Download `AUCRainmeterWidget.ini` from [here](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/AUCRainmeterWidget.ini) (you can download it by right-clicking the link and pressing \"Save Link As...\")\n3. Find your Rainmeter skins folder (usually in `%USERPROFILE%\\Documents\\Rainmeter\\Skins`)\n4. Create a new folder (e.g. tech189) and place the downloaded `.ini` file into it\n5. Right click the Rainmeter icon on the taskbar in the notification area and press \"Refresh all\"\n6. Right click the Rainmeter icon again and click on \"Skins\" then \"tech189\" (the name of the folder created in step 3) and select `AUCRainmeterWidget.ini`\n7. The updated widget should appear on your desktop\n\n#### Updating\n\n1. Find your Rainmeter skins folder (usually in `%USERPROFILE%\\Documents\\Rainmeter\\Skins`)\n2. Open the folder where you placed `AUCRainmeterWidget.ini` and delete the old .ini file\n3. Copy into this folder [`AUCRainmeterWidget.ini`](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/AUCRainmeterWidget.ini) (you can download it by right-clicking the link and pressing \"Save Link As...\")\n4. Right click the Rainmeter icon on the taskbar in the notification area and press \"Refresh all\"\n5. The updated widget should appear on your desktop for you to move around\n\n### Übersicht Widget (macOS)\n\n#### Summary\n\n- Install [Python 3](https://www.python.org/) and [Übersicht](http://tracesof.net/uebersicht/) via [Homebrew](https://brew.sh):\n\n    ```text\n    /usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n\n    brew install python3 \u0026\u0026 brew cask install ubersicht\n    ```\n\n- Übersicht menu bar \u003e Open Widgets Folder\n- Copy [auc.coffee](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.coffee) and [auc.py](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.py) into a folder called `ab-urbe-condita.widget` located in your Übersicht widget folder (the one you just opened)\n- Übersicht menu bar \u003e Refresh All Widgets\n- Übersicht menu bar \u003e Preferences... \u003e Launch Übersicht when I login\n\n#### Step by step\n\n1. Open Terminal (command+space to search, then type `terminal`, and press enter)\n2. Go to the [Homebrew website](https://brew.sh) and copy and paste the installation command into the Terminal window:\n\n    ```text\n    /usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n    ```\n\n3. Press enter to start and press enter at any prompts\n4. After it says \"installation successful\", type the following command into the terminal window and press enter\n\n    ```text\n    brew install python3 \u0026\u0026 brew cask install ubersicht\n    ```\n\n5. Open Übersicht (command+space to search, then type `ubersicht`, and press enter)\n6. Click on the Übersicht menubar icon at the top of your screen (a 'u' with glasses on top), then on \"Open Widgets Folder\"\n7. Delete the files in the folder you just opened\n8. Create a new folder called \"ab-urbe-condita.widget\" and copy into it [auc.coffee](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.coffee) and [auc.py](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.py) (you can download them by right-clicking these links and pressing \"Save Link As...\")\n9. Click on the Übersicht menubar icon again and click \"Refresh All Widgets\", the AUC widget should appear on your desktop by this point if it hadn't already.\n10. Finally click on the Übersicht menubar icon for the last time and open its \"Preferences...\" option, then tick \"Launch Übersicht when I login\" to make sure the widget loads at start-up!\n\n#### Updating\n\n1. Click on the Übersicht menubar icon and click \"Open Widgets Folder\"\n2. Open the \"ab-urbe-condita.widget\" folder and delete the old auc.coffee and auc.py files inside it\n3. Copy into this folder [auc.coffee](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.coffee) and [auc.py](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.py) (you can download them by right-clicking these links and pressing \"Save Link As...\")\n4. Click on the Übersicht menubar icon again and click \"Refresh All Widgets\", the AUC widget should refresh and the updated files should work\n\n\u003c!-- \n## BitBar Plugin (macOS)\n\n### Summary\n\n- Install `python3` via [Homebrew](www.brew.sh) if not already installed\n- Install [my BitBar build](http://www.tech189.duckdns.org/BitBar.zip)\n- Copy [my BitBar plugin](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.1m.py) to your plugin folder\n- Allow plugin to be executed (`chmod +x`)\n- Remove date from built-in clock and rearrange the BitBar plugin next to the clock\n\n### Step by step\n\n1. Open Terminal (command+space to search, then type `terminal`, and press enter)\n2. Go to the [Homebrew website](www.brew.sh) and copy and paste the installation command into the Terminal window\n3. Press enter to start and press enter at any prompts\n4. After it says \"installation successful\", type `brew install python3` into the terminal window and press enter\n5. Click your clock on your menu bar and press \"Open Date \u0026 Time Preferences…\" then untick \"Show the day of the week\"\n6. Close the System Preferences window\n7. Download `BitBar` (from [here](http://www.tech189.duckdns.org/BitBar.zip)) and double click the downloaded file to unzip it\n8. Now copy `BitBar` to your Applications folder, and open it (same way as opening Terminal in step 1) - it will appear hopefully on your menubar, if not, minimize all your windows and click on the desktop\n9. Ignore the insecure update error (it's an unsigned build I made because the official version hasn't been released yet), then it will prompt you to choose a plugins folder (I'd go for `~/Documents/BitBar Plugins`)\n10. Copy my [my BitBar plugin](https://raw.githubusercontent.com/tech189/Ab-Urbe-Condita/master/auc.1m.py) file into the plugin folder you just chose\n11. Navigate up one folder from the plugin folder (command+up arrow key)\n12. Right click on the plugin folder and press \"New Terminal Tab at Folder\"\n13. Type in `chmod +x auc.1m.py` and press enter\n14. Click the BitBar button on your menu bar and press \"Reset all\"\n15. The date should now appear on your menu bar: command+click and drag the date next to your normal clock\n16. Click on the date and behold the Roman date/time, then click on Preferences and make sure Open at Login is ticked --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftech189%2Fab-urbe-condita","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftech189%2Fab-urbe-condita","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftech189%2Fab-urbe-condita/lists"}