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.5.tar.gz (3.6 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: jn_skey-1.0.5.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.5.tar.gz
Algorithm Hash digest
SHA256 ee561626e7ef921033fa9a824f757e491aaa5c93728d54b33c5028d3e4bfc1f2
MD5 48baf6e4321f3d01982c888b285fa271
BLAKE2b-256 8196f0596e32362b8725db4719151dea7ffdd6a932054b8afb37ee2a55e3ff11

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jn_skey-1.0.5-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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 a3e6c126b44378b264d9df9ca1c7bf9c62cb6076861763e15bccc7b299251222
MD5 c51cdf93be52ed5325b41ef51a0af00c
BLAKE2b-256 6dca5126cad7d97aad4eed3f71e2d4c47f59f0ca82bc3766a988a8fc020bd742

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