UPDATE: PsychoTimer now supports web browsers! Check out the dorpascal.com/talking-timer/ for a quick and easy way to manage your time.
Psycho Timer is a Python program designed specifically for candidates preparing for the Psychometric Entrance Test (PET). It aids in effective time management during the test by setting individual timers for each section of the exam, providing audible instructions and alerts, allow tests modifications and more - all combined with a simple user interface.
- ๐ News
- โจ Features
- ๐ฆ Dependencies
- ๐ Installation
- ๐ Usage
- ๐ Files
- ๐ Classes - Behind the Scenes
- ๐ Contributing
- ๐ License
The program has recently been updated to support text-to-speech capabilities not only with Azure
but also with Google Text-to-Speech
and even a local text-to-speech engine, providing enhanced flexibility and accessibility. It can now run without an internet connection , without requiring an Azure SDK key and without using a single byte for audio files.
Features has been tested on macOS and Ubuntu 22.04.
-
๐ Speaker Factory: New feature that automatically selects the best available text-to-speech engine based on the user's system and internet connectivity. It has the capability to fallback to Google Text-to-Speech and a local text-to-speech engine, enabling the program to run without an internet connection or an Azure SDK key.
Use
FatimaNeural
voice!Or use
UzmaNeural
voice - use ANY VOICE! -
๐ Dynamic Section Timers: Set up individual timers for each section of the PET based on user input.
-
๐ Voice Alerts: Utilize Azure's text-to-speech capabilities to provide audible alerts, enhancing the user experience.
-
๐ฃ Randomized Voice Selection: Every time the program starts, a unique voice is randomly selected for the text-to-speech synthesizer.
-
๐ Optional Essay Section: Choose to include a 30-minute essay section at the start of the exam.
-
โธ Pause & Resume: Easily pause the timer with the "P" key and resume with the "R" key.
-
โ Quick Exit: Press "Q" to quickly quit the program anytime.
-
๐งฉ Modular Structure: Separate modules for different functionalities (
my_timer.py
,my_setup.py
,io_util.py
,SetupManager
) make it easier for developers to understand and contribute.
This project uses a mix of Python Standard Library modules and Third-Party Libraries. Below is a list:
threading
typing
atexit
curses
time
socket
subprocess
gtts
(Google Text-to-Speech)pyttsx3
azure.cognitiveservices.speech
mpg321
(for playing audio files with google text-to-speech)
You can install the required third-party libraries using pip:
pip install gtts pyttsx3 azure-cognitiveservices-speech
- Clone the repository to your local machine.
- Install the required packages (see Dependencies).
- Optional:
- If you want to use Azure's text-to-speech capabilities, you will need to create an Azure account and get an Azure SDK key. You can follow the instructions here.
- Create a new file called
azure_sdk_key.txt
in the same directory asmain.py
. - Paste your Azure SDK key into the
azure_sdk_key.txt
file and save it.
- Run the program by running
python main.py
.
Program includes interactive walkthrogh:
- When prompted, enter the number of sections in the PET.
- Follow the on-screen instructions to start and stop the timer for each section.
- Press "P" to pause the timer, and "R" to resume the timer.
- Press "Q" to quit the program.
main.py
: The main program file.my_timer.py
: A module that contains thesection_timer
function for managing the section timer.my_setup.py
: A module that contains thesetup
function for setting up the program.io_util.py
: A module that contains utility functions for handling input and output.azure_sdk_key.txt
: A file that contains your Azure SDK key (Optional).README.md
: The README file.
A new addition to the codebase, the SpeakerFactory
class serves as a factory for generating the appropriate speaker (text-to-speech engine) based on the system and connectivity. It encapsulates the logic for determining the best available speaker service to use and returns an instance of the corresponding speaker wrapper class (AzureWrapper
, GttsAsyncWrapper
, Pyttsx3AzureWrapper
).
- Internet Connection Check: Checks whether an internet connection is available.
- Ubuntu 22.04 Check: Determines if the system is running Ubuntu 22.04.
- Azure SDK Key Availability: Checks for the existence of an Azure SDK key.
- Speaker Instance Creation: Based on the above checks, it initializes and returns an appropriate speaker instance.
create_speaker
: Creates and returns an appropriate speaker instance.check_internet_connection
: Checks for internet connectivity.is_ubuntu_2204
: Checks if the system is running on Ubuntu 22.04.read_azure_sdk_key
: Reads the Azure SDK key from a file.
This class handles the orchestration of multiple threads, including threads for timing (timer_thread
), output (output_thread
), and input (input_thread
). It provides methods for preparing thread arguments, starting threads, and joining them back.
-
Event Initialization: Initializes several threading events like
stop_flag
,clock_ticking
,output_event
,exit_flag
, andextra_essay
that control the flow and behavior of the various threads. -
Thread Arguments Preparation: Methods like
get_timer_args
,get_output_args
, andget_input_args
prepare and return the sets of arguments needed for each of the threads. -
Thread Execution: Uses the
run_threads
method to start all threads and thejoin_threads
method to join them back, ensuring they have completed their execution. -
Resource Cleanup: Implements the
__enter__
and__exit__
methods to allow the object to be used with Python'swith
statement, ensuring that all threads are joined back at the end of the operation.
__init__
: Initializes thread events and sets basic configuration like warning times, chapters, and whether an extra essay is included.initialize_events
: Initializes thread event objects for controlling thread behavior.get_timer_args
,get_output_args
,get_input_args
: Prepare arguments for timer, output, and input threads, respectively.run_threads
: Initiates and runs all the threads.join_threads
: Joins all the threads ensuring they have completed their execution.
The class follows the Context Manager protocol, allowing it to be used with Python's with
statement. This ensures that all resources are properly cleaned up once out of scope.
threading
: Used for handling threads.my_timer
: Contains the function for the timer thread.my_setup.SetupManager
: For initial setup.io_util
: Contains utility functions for input and output.
Manages the program setup, including initializing the Azure text-to-speech synthesizer and handling user input for setting up the test chapters. It uses the azure.cognitiveservices.speech
library for Azure's text-to-speech capabilities. The class follows a context manager pattern, using __enter__
and __exit__
methods to manage resources.
- Resource Management: It uses the context manager methods (
__enter__
and__exit__
) to handle Azure synthesizer resource allocation and deallocation. - User Interactions: This class takes care of fetching input from the user regarding the number of chapters and whether an extra essay is needed.
- Speech Synthesis: It initializes a speech synthesizer and selects a random voice for the session.
- Validity Checks: The class contains methods to validate user inputs.
Contributions are welcome! Please fork the repository and submit a pull request.
This project is licensed under the MIT License.
Note: This is an unofficial timer tool designed to help with the Israeli standard exam. This project is not affiliated with or endorsed by the official exam body.