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

Uploaded Source

Built Distribution

jn_skey-1.0.0-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: jn_skey-1.0.0.tar.gz
  • Upload date:
  • Size: 3.4 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.0.tar.gz
Algorithm Hash digest
SHA256 d3d9e8f2556816b3abe0f16b71b580d9916747fa09b7a7e50d94e0b159d38000
MD5 cebea15143d18c78224e707627c9e296
BLAKE2b-256 3d3a84aa10a4adcc8191318f7dfb78aa751ad670aa22e15a746bb801f46319ab

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jn_skey-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.8 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b127b351077d50bf2d6fa1f44a43fc0abecc90a44b564845f90febbc087d3532
MD5 3855849862a750f9513551d3d9b935c7
BLAKE2b-256 1a209b5c07a7dc402b9944607735fc26da9703e73b99cdfbea0446fc3fcb3912

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