Skip to content

Announce the time every hour similar to Mac OS X. Say the Time using Google TTS or espeak.

License

Notifications You must be signed in to change notification settings

wallacesilva/timespeaker

Repository files navigation

TimeSpeaker

Announce the time every hour similar to Mac OS X. Say the Time using Google TTS or espeak.

Timespeaker - Logo

Requirements

  • python3.6+
  • playsound
  • gtts or pyttsx3

For development

  • poetry
  • flake8
  • black
  • pytest

TODO

  • Use python: threading.Timer
  • Create tests
  • Add system tray (opcional) by cli
  • Update/Fix to PyPi (pip install timespeaker)
  • Move Makefile to Parent
  • Configure PULL_REQUESTS AND ISSUES template
  • Configure lint
  • Configure formatter
  • Configure github actions (or circleci)
  • Test i3 configs
  • Add support to Cron
  • Use a global DEBUG
  • When merge to main build and publish to PyPi (github actions)

Install

Default (Working In Progress)

pip install timespeaker

Local

On Local User

# pyenv shell +3.6.0
# asdf shell python +3.6.0

# optional (poetry create a virtualenv for you)
python -m venv .venv 

# install dependencies
make install

# clean old builds
make clean

# build package
make build

# install on local user package (python)
pip install --user dist/{path_from_last_command}.whl

Test local install

timespeaker check --speaker gtts

Configure

AutoStart (Working In Progress)

make configure-autostart

i3 (Working In Progress)

make configure-i3

Cron (Working In Progress)

Coming Soon

sudo make configure-cron

Systemd (Working In Progress)

sudo make configure-systemd

Remove configurations

# Systemd
sudo make remove-systemd

# Autostart
make remove-autostart

# i3
# coming soon

# Cron
# coming soon

Usage

Default usage using gtts to speak and saving in /tmp/timespeaker/

# after make install (or poetry install)
poetry run timespeaker start

# OR if configured (local user or via pip install timespeaker)
timespeaker start

Custom command:

poetry run timespeaker start --speaker=pyttsx3 --player=vlc --path-folder=/tmp/timespeaker/

How to check sounds

This speakes sound each 2 second from midnight to 23 hours.

poetry run timespeaker check-hours-sound gtts

Development

Using virtualenv (python venv):

# create virtualenv
# virtualenv .venv [-p /path/to/python3.6+] # require virtualenv
python -m venv .venv

# Enter virtualenv
source .venv/bin/activate

# to exit of virtual env run 
deactivate

Dev install (poetry required)

poetry install

See more commands with

make help

Tests

make test

License

MIT LICENSE

Contributing

I encourage you to contribute to this project! Join us!

Trying to report a possible security vulnerability? Open a issue now

Everyone interacting in this project and its sub-projects' codebases, issue trackers, chat rooms, and mailing lists is expected to follow the code of conduct (building, but respect everyone).

Releases

No releases published

Sponsor this project

Packages

No packages published