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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | a398a4ee3d81f9c84812404f6e31d5cc8a4227c7352cf1b0d5a8881d2f5586a7 |
|
MD5 | fab6132d96dbb2b47a229736b62a909b |
|
BLAKE2b-256 | b163fd0fd877a92d94c3d2ab65c3e7a82a808672b62d8924993a3bef754c1e83 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf8887784844289b292229aa9f0823456895b45ee9fa8af8c30c9d7b71f59e33 |
|
MD5 | c252255d001e351d2b0894affa05688e |
|
BLAKE2b-256 | 56ffa020bdbe748d85b69f02ccedab1b62b42753efcd07587cd1634598c9ca5b |