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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: jn_skey-1.0.6.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.6.tar.gz
Algorithm Hash digest
SHA256 a398a4ee3d81f9c84812404f6e31d5cc8a4227c7352cf1b0d5a8881d2f5586a7
MD5 fab6132d96dbb2b47a229736b62a909b
BLAKE2b-256 b163fd0fd877a92d94c3d2ab65c3e7a82a808672b62d8924993a3bef754c1e83

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jn_skey-1.0.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 bf8887784844289b292229aa9f0823456895b45ee9fa8af8c30c9d7b71f59e33
MD5 c252255d001e351d2b0894affa05688e
BLAKE2b-256 56ffa020bdbe748d85b69f02ccedab1b62b42753efcd07587cd1634598c9ca5b

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