https://github.com/Demonstrandum/WordTime

A macOS menu bar item which tells the time in words.
https://github.com/Demonstrandum/WordTime

app macos macos-menu menubar osx pyobjc python toolbar topbar unix

Last synced: 26 days ago
JSON representation

A macOS menu bar item which tells the time in words.

• Host: GitHub
• URL: https://github.com/Demonstrandum/WordTime
• Owner: Demonstrandum
• License: gpl-3.0
• Created: 2017-04-07T22:16:46.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-09-17T18:57:37.000Z (about 7 years ago)
• Last Synced: 2024-11-13T11:52:54.146Z (29 days ago)
• Topics: app, macos, macos-menu, menubar, osx, pyobjc, python, toolbar, topbar, unix
• Language: Python
• Size: 38.1 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Mac-Menubar-Megalist - WordTime

README

        
# WordTime

A macOS menu bar item which tells the time in words.

Download with `git` using:


`git clone https://github.com/Demonstrandum/WordTime && cd ./WordTime`


Then, install dependencies and the package with:


`python setup.py install`


Now you can start it from the terminal


or enable it on login using autorun.py

Dependencies:


`pyobjc` & `rumps`

for macOS menubar interaction.

![Image of menubar](https://cloud.githubusercontent.com/assets/26842759/24832420/dd17b148-1ca7-11e7-84c0-f1acb231665a.png)



## Start on login (autorun)

Use `autorun.py` after having installed through  `setup.py` to enable the automatic start of WordTime. Run the command `python autorun.py enable` in your terminal to enable WordTime on login. To disable WordTime autorun, run `python autorun.py disable`, then you can always reenable it again.

## Notice

Do not use standard python that comes with macOS, install python ~2.7 with pip usually in `/usr/local/bin/python`, for example python from the brew package manager, e.g. `brew install python` or from the official website.

To stop `wordtime` press the item and press 'Quit'.



#### Start from terminal or for using it in terminal

To start the menu bar item from the terminal simply write `wordtime` or `wordtime &` to run it int the background in your terminal, make sure to have `/usr/local/bin/` in your `PATH`, This is only for macOS, if you installed it wordtime on another OS, remove `/usr/local/bin/wordtime` as this executable will only work on macOS.

##### Other OSs

If you are using another OS, to run it in the terminal run `python terminal.py` this doesn't need any of the dependencies and works only when in the same directory as the `wordtime` folder or you have installed it through `python setup.py install`.