Skip to main content

A Geeky Timer for Terminal Enthusiasts

Project description

MyTimer: A Geeky Timer for Terminal Enthusiasts


PyPI version built with Python3

Table of contents

Overview

MyTimer is a Python project that aims to provide a simple yet efficient timer for terminal users, particularly targeting the geek community. This project allows users to set timers directly from their command line interface, making it convenient for those who spend a significant amount of time working in the terminal!

The main objective of MyTimer is to offer a minimalistic and distraction-free timer experience. It provides a clean and straightforward interface, ensuring that users can focus solely on tracking time without any unnecessary clutter or distractions.

PyPI Counter
Github Stars
Branch main dev
CI
Code Quality CodeFactor codebeat badge

Installation

Source Code

PyPI

Usage

⚠️ You can use mytimer or python -m mytimer to run this program

Version

mytimer --version

Basic

⚠️ Press Ctrl + C to exit

mytimer

Time Limit

mytimer --minute=7 --second=30
mytimer --hour=2 --minute=20

Timer Mode

⚠️ The default mode is count-up

mytimer --minute=7 --second=30 --countdown
mytimer --minute=7 --second=30 --countup

Alarm

⚠️ This mode may not be supported on all systems

mytimer --minute=7 --second=30 --alarm

Alarm Repeat

⚠️ The default value is 1

mytimer --minute=7 --second=30 --alarm --alarm-repeat=5

Tone

⚠️ The default tone is 1

mytimer --minute=7 --second=30 --alarm --tone=2

Face

mytimer --minute=7 --second=30 --face=3

Program

mytimer --program=black-tea

Message

mytimer --minute=7 --second=30 --message="Test message"

Screen Record

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

  • Please complete the issue template

References

1- Mixkit Free Alarm Sound Effects
2- Online Timer
3- Media College

Show your support

Star this repo

Give a ⭐️ if this project helped you!

Donate to our project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

Unreleased

0.9 - 2023-10-04

Added

  • 4 new faces
  • 4 new programs
    1. work
    2. short-break
    3. long-break
    4. noodle

Changed

  • PROGRAMS.md updated

0.8 - 2023-08-07

Added

  • Logo
  • --alarm-repeat argument

Changed

  • Tones length modified
  • README.md updated

0.7 - 2023-07-23

Added

  • --tone argument
  • TONES.md
  • 9 new tones

Changed

  • Test system modified
  • input_check decorator renamed to input_handler
  • countup_timer function inputs modified
  • countdown_timer function inputs modified
  • PROGRAMS.md updated
  • FACES.md updated

0.6 - 2023-07-04

Added

  • --program argument
  • PROGRAMS.md
  • run_timer function

Changed

  • Inputs type changed to int
  • README.md updated
  • WRONG_INPUT_ERROR renamed to INPUT_ERROR_MESSAGE
  • Alarm tone changed

0.5 - 2023-05-25

Added

  • 5 new faces
  • --message argument

Changed

  • play_sound function modified
  • playsound removed from requirements.txt
  • README.md updated

0.4 - 2023-02-10

Added

  • 4 new faces
  • Infinite timer mode

Changed

  • README.md updated
  • Parameters moved to params.py

0.3 - 2022-11-25

Added

  • --face argument
  • FACES.md

Changed

  • README.md updated
  • Minimum art library version changed from 1.8 to 2.9

0.2 - 2022-11-03

Added

  • --version flag

Changed

  • Test system modified
  • countdown_timer function modified
  • countup_timer function modified

0.1 - 2022-10-18

Added

  • Countdown mode
  • Count-up mode
  • Alarm

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mytimer-0.9.tar.gz (603.5 kB view hashes)

Uploaded Source

Built Distribution

mytimer-0.9-py3-none-any.whl (593.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page