Skip to main content

A tool to insert the current datetime using a keyboard shortcut.

Project description

jn-skey

jn-skey is a Python command-line tool that allows you to quickly insert the current date and time into any text field by using a customizable keyboard shortcut. This tool is particularly useful for those who need to timestamp entries frequently.

Features

  • Insert the current date and time in the format YYYY-MM-DD hh:mm:ss.
  • Configurable keyboard shortcut for triggering the insertion.
  • Lightweight and easy to use.

Installation

You can install jn-skey via pip. To do so, run:

pip install jn-skey

Usage

After installation, you can run the jn-skey command from your terminal. Once running, the tool listens for a specific keyboard shortcut to insert the current date and time.

Default Keyboard Shortcut

The default keyboard shortcut is:

SHIFT + ALT + *

When this combination is pressed, the current date and time in the format YYYY-MM-DD hh:mm:ss will be typed out at the cursor's position.

Running the Command

To start the tool, simply open a terminal and run:

jn-skey

The tool will output a message indicating that it is listening for the keyboard shortcut.

Example

SHORTCUT KEY FOR YYYY-MM-DD hh:mm:ss IS SHIFT + ALT + * (main keyboard)

Pressing SHIFT + ALT + * will then type something like:

2024-09-06 12:45:30

Requirements

  • Python 3.6 or higher
  • pynput library (automatically installed with the package)

Contributing

Contributions are welcome! If you'd like to improve this package, feel free to fork the repository and submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

If you have any questions or suggestions, feel free to open an issue or contact me at your.email@example.com.

Acknowledgments

  • pynput - Used for keyboard event handling.

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

jn_skey-1.0.7.tar.gz (3.6 kB view details)

Uploaded Source

Built Distribution

jn_skey-1.0.7-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file jn_skey-1.0.7.tar.gz.

File metadata

  • Download URL: jn_skey-1.0.7.tar.gz
  • Upload date:
  • Size: 3.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for jn_skey-1.0.7.tar.gz
Algorithm Hash digest
SHA256 e3dc53a1f3b963b92e215eca7e6231950f08237a283280d513487bda22b81144
MD5 c69f59345a81d57ee3d63fe3ee997f1d
BLAKE2b-256 e9c5835ce7eb16619a90c3b5adf428699b8a5bcd167f81c8dbf8204862836f7f

See more details on using hashes here.

File details

Details for the file jn_skey-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: jn_skey-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 4.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for jn_skey-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 266628a29edd7ef482114a3fa443b896ca87c67fad2e41d5e97fe273173a8eae
MD5 03aa877dbd6a232650713143d7266718
BLAKE2b-256 85ae4b0b8ddcac3f82dcb81d77c178885f6a144814a97c25e26ac08ed9233519

See more details on using hashes here.

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