https://github.com/tech189/ab-urbe-condita
Outputs time and date in Roman dating system
https://github.com/tech189/ab-urbe-condita
classics clock latin python rainmeter roman ubersicht
Last synced: 6 months ago
JSON representation
Outputs time and date in Roman dating system
- Host: GitHub
- URL: https://github.com/tech189/ab-urbe-condita
- Owner: tech189
- License: mit
- Created: 2019-06-13T22:32:17.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-02-24T16:16:44.000Z (over 3 years ago)
- Last Synced: 2025-02-13T15:36:25.121Z (8 months ago)
- Topics: classics, clock, latin, python, rainmeter, roman, ubersicht
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ab Urbe Condita
A small program to convert times and dates into the Roman system.
Run `auc.py` with no arguments to output current date and time or use the following arguments:
```text
--json output in JSON for portability
--simple only print the Roman format
--idiomatic abbreviated dates to be more idiomatic
--custom convert a custom date (ISO 8601)
--debug print calculations etc. for debugging
```
For example:
```text
python3 auc.py
23:27, Thursday, 13 June 2019 AD
hora II post solis occasum
dies Iovis
Idus Junias
MMDCCLXXII AUC
```
To use a custom date, you must use the ISO 8601 format, for example:
```text
python3 auc.py --custom 1234-05-06
Saturday, 6 May 1234 AD
dies Saturni
pridie Nonas Majas
MCMLXXXVII AUC
```
To use the data in other programs, simply use the `--json` argument:
```json
python3 auc.py --json
{"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"}}
```
Or, if you're writing in Python, you could `import` it in your program:
```python
>>> import auc, datetime
>>> print("hodie est " + auc.get_day(datetime.datetime.now()) + "!")
hodie est dies Jovis!
```
## Widgets!
There 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)).
### Rainmeter Widget (Windows)
#### Step by step
1. (Install [Rainmeter](https://www.rainmeter.net/) and open it at least once)
2. 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...")
3. Find your Rainmeter skins folder (usually in `%USERPROFILE%\Documents\Rainmeter\Skins`)
4. Create a new folder (e.g. tech189) and place the downloaded `.ini` file into it
5. Right click the Rainmeter icon on the taskbar in the notification area and press "Refresh all"
6. 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`
7. The updated widget should appear on your desktop
#### Updating
1. Find your Rainmeter skins folder (usually in `%USERPROFILE%\Documents\Rainmeter\Skins`)
2. Open the folder where you placed `AUCRainmeterWidget.ini` and delete the old .ini file
3. 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...")
4. Right click the Rainmeter icon on the taskbar in the notification area and press "Refresh all"
5. The updated widget should appear on your desktop for you to move around
### Übersicht Widget (macOS)
#### Summary
- Install [Python 3](https://www.python.org/) and [Übersicht](http://tracesof.net/uebersicht/) via [Homebrew](https://brew.sh):
```text
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install python3 && brew cask install ubersicht
```
- Übersicht menu bar > Open Widgets Folder
- 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)
- Übersicht menu bar > Refresh All Widgets
- Übersicht menu bar > Preferences... > Launch Übersicht when I login
#### Step by step
1. Open Terminal (command+space to search, then type `terminal`, and press enter)
2. Go to the [Homebrew website](https://brew.sh) and copy and paste the installation command into the Terminal window:
```text
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
3. Press enter to start and press enter at any prompts
4. After it says "installation successful", type the following command into the terminal window and press enter
```text
brew install python3 && brew cask install ubersicht
```
5. Open Übersicht (command+space to search, then type `ubersicht`, and press enter)
6. Click on the Übersicht menubar icon at the top of your screen (a 'u' with glasses on top), then on "Open Widgets Folder"
7. Delete the files in the folder you just opened
8. 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...")
9. 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.
10. 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!
#### Updating
1. Click on the Übersicht menubar icon and click "Open Widgets Folder"
2. Open the "ab-urbe-condita.widget" folder and delete the old auc.coffee and auc.py files inside it
3. 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...")
4. Click on the Übersicht menubar icon again and click "Refresh All Widgets", the AUC widget should refresh and the updated files should work