Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anirudhg07/ntfyme
Simple terminal command line notification tool on completion of your commands and processes.
https://github.com/anirudhg07/ntfyme
cli notification notify
Last synced: 9 days ago
JSON representation
Simple terminal command line notification tool on completion of your commands and processes.
- Host: GitHub
- URL: https://github.com/anirudhg07/ntfyme
- Owner: AnirudhG07
- License: mit
- Created: 2024-07-21T05:37:47.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-08T15:35:41.000Z (about 1 month ago)
- Last Synced: 2024-11-11T06:24:11.702Z (9 days ago)
- Topics: cli, notification, notify
- Language: Python
- Homepage:
- Size: 69.2 MB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ntfyme 📣 
📷 Previews/Screenshots •
⚡Features •
🔥Usages •
🔨Installation •
⭐Getting Started
Have you ever wanted a simple tool in your terminal which gives you notification when the program is done, like some computer notification or some mail.
This tool helps you ease your life with appropriate notifications you can set in your OS, get mail regarding it and best of all, it is VERY SIMPLE TO USE!
`ntfyme` stands for 'notify-me', obviously! So just write your command and pipe the notification of its Error(or Success) with ntfyme.
## 📷 Previews
### Command line Usage
https://github.com/user-attachments/assets/a96a55be-7a38-45b8-999d-11742801aaa9
You can run any command, from regular command line to computational biology commands to any other!
### Gmail
You can get texts for smaller outputs and text files for bigger outputs upto the limit GMAIL allows.
### Telegram bot messages
After setting up your telegram bot, you can get similar outputs there too with NOTIFICATION.
and more ...
## ⚡ Features
- ✨ Very easy to use and setup.
- ✨ Cross platform support for Windows, MacOS and Linux.
- ✨ Get local notifications when your command is done.
- ✨ Get notifications like gmail, telegram bot, etc. when your command is done.
- ✨ Get information about output, errors, time taken, pid and more in the notification.
- ✨ Track your process for possible suspensions and get notified after thorough diagnostics.
- ✨ Enhanced UI features powered by rich and beaupy.
## 🔥 Usages
Say you want to run your terminal command called ``, which can be running some python script, some shell scripts, or any terminal regular command.
There are mainly two ways to use the tool to get a notification -
### 1. Direct Run
For "direct running", you can follow the below format -
```bash
ntfyme exec -c
```
### 2. Piping the command
For "piping the command", you can follow the below format -
```bash
echo | ntfyme exec
```
Both the above commands will give the SAME output, a notification when the command is done.
> [!Note]
>
> For Windows, it is recommended to enclose you commands in double quotes. For example - `ntfyme exec -c "echo hi"`.
### More examples
1. To run multiple commands, you can use the `"multiple commands"` syntax to input to ntfyme. For example -
```bash
echo "echo hi; touch hello.txt; echo 'What a day!' > hello.txt" | ntfyme exec
```
The net output will be outputted for such commands with an overall diagnostics instead of seperate for each command.
2. Running ssh will not work with ntfyme. Although one can use it to test the connection and then run the command. For example -
```bash
echo "nmap 1.1.1.1 -p 22" | ntfyme exec
```
This command may take some time to run, but will give you a notification when the command is done.
3. If you would like to get notifications for an ssh command, you would need to install `ntfyme` on the remote machine, give your gmail id and app password in the `config.toml`.
## 🔨 Installation
You can install this tool with the below options available:
### Pypi Installation
You can download this tool by running the below command -
```bash
pip install ntfyme
```
> [!Tip]
>
> For Windows, you may get a mesage to add `C:\Users\your\path\to\Python31x\Scripts`(whatever you get) to path, refer this [guide](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho). Please add it to the path in order to run ntfyme.
### Homebrew Installation(for MacOS)
This tool can downloaded from my Homebrew tap, by running the below command -
```bash
brew install anirudhg07/anirudhg07/ntfyme
```
### Manual Installation
You can download the source code from the repository and run the below command to install the tool -
```bash
git clone https://github.com/AnirudhG07/ntfyme.git
cd ntfyme
pip install .
```
> [!Important]
>
> WSL will be counted as windows instead of linux, thus notifications will be done through "plyer" library instead of linux notify-send. To complete the installation process for WSL, please run [wsl.sh](https://github.com/AnirudhG07/ntfyme/blob/main/docs/setup_guide/wsl.sh) script in your WSL terminal with sudo permissions. You can do this by running -
```bash
chmod +x wsl.sh
sudo ./wsl.sh
```
## ⭐ Getting Started
To get started with `ntfyme`, first download the tool using the above installation methods. To enable notifications through gmail or telegram bot, you will need to setup the respective services manually. The guides to setup the services are mentioned in the docs.
To know more about the `config.toml` and configurations, read below.
## Configurations
`ntfyme` allows you to configure the tool according to your needs. The configurations are stored in the `config.toml` which you can open using root privilages while running `ntfyme --config`. Let's understand some of the configurations below.
`ntfyme` uses `on/off` to enable/disable ny settings. Please do not input any other values other than `on/off` for the `enabled` option. The comments for each option is mentioned, please read them before changing any option. They will give a thorough idea about the configurations and their usage.
Please do not mess around with the `config.toml` file, as it may lead to some errors in the tool.
## Contribute
You are very welcome to contribute to this project. If you find bugs, or more API's for notifications, some more features, etc. feel free to create an issue, discuss and then make a PR. To make `ntfyme` better and used throughout the world, please star and share this repo to everyone!