[GH-ISSUE #1553] A tiny client to simplify notification pushes. [Pull Request?] #1095

Closed
opened 2026-05-07 00:30:13 +02:00 by BreizhHardware · 2 comments

Originally created by @Gamedirection on GitHub (Jan 17, 2026).
Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/1553

This may already exist (probably even a better version), I just wanted to make one for my self and would like to share 💃

💡 Idea

https://github.com/Gamedirection/ntfy/tree/cli-only/client/cli
Created a small script to simplify using ntfy in the linux terminal.

❯ ntfy -h

  echo "msg" | ntfy [flags]

Runtime options:
  -u, --url [URL]      HTTP(S) endpoint to POST data to.
                       If omitted, defaults to: $(current-url)
                       If used *without* URL, prints current effective URL.

  -t, --topic [NAME]   Topic name; used only when --url is not given.
                       If used *without* NAME, prints current topic.

  -m, --method [M]     HTTP method: GET or POST (default: $(current-method))
                       If used *without* M, prints current method.

Persistent defaults (saved in /home/interfaceas/.config/ntfy-cli.conf):
  -su, --set-url URL      Set default base URL.
  -st, --set-topic NAME   Set default topic.
  -sm, --set-method M     Set default method (GET or POST).

Other:
  -v, --version        Show version and exit.
  -h, --help           Show this help and exit.

Message:
  If stdin is not a TTY, body is read from stdin.
  Otherwise, any remaining arguments after flags form the message:
      ntfy "Hello World"
      ntfy -u https://ntfy.gamedirection.net -t dogs "hello world"

Environment overrides:
  NTFY_BASE_URL   Base URL
  NTFY_TOPIC      Default topic

💻 Target components

This is a small cli app that will live on Linux devices. Can be installed on a few shells.

Originally created by @Gamedirection on GitHub (Jan 17, 2026). Original GitHub issue: https://github.com/binwiederhier/ntfy/issues/1553 This may already exist (probably even a better version), I just wanted to make one for my self and would like to share 💃 <!-- Before you submit, consider asking on Discord/Matrix instead. You'll usually get an answer sooner, and there are more people there to help! - Discord: https://discord.gg/cT7ECsZj9w - Matrix: https://matrix.to/#/#ntfy:matrix.org / https://matrix.to/#/#ntfy-space:matrix.org --> :bulb: **Idea** <!-- Share your thoughts; try to be detailed if you can --> [https://github.com/Gamedirection/ntfy/tree/cli-only/client/cli](https://github.com/Gamedirection/ntfy/tree/cli-only/client/cli) Created a small script to simplify using ntfy in the linux terminal. ``` ❯ ntfy -h echo "msg" | ntfy [flags] Runtime options: -u, --url [URL] HTTP(S) endpoint to POST data to. If omitted, defaults to: $(current-url) If used *without* URL, prints current effective URL. -t, --topic [NAME] Topic name; used only when --url is not given. If used *without* NAME, prints current topic. -m, --method [M] HTTP method: GET or POST (default: $(current-method)) If used *without* M, prints current method. Persistent defaults (saved in /home/interfaceas/.config/ntfy-cli.conf): -su, --set-url URL Set default base URL. -st, --set-topic NAME Set default topic. -sm, --set-method M Set default method (GET or POST). Other: -v, --version Show version and exit. -h, --help Show this help and exit. Message: If stdin is not a TTY, body is read from stdin. Otherwise, any remaining arguments after flags form the message: ntfy "Hello World" ntfy -u https://ntfy.gamedirection.net -t dogs "hello world" Environment overrides: NTFY_BASE_URL Base URL NTFY_TOPIC Default topic ``` :computer: **Target components** <!-- Where should this feature/enhancement be added? --> <!-- e.g. ntfy server, Android app, iOS app, web app --> This is a small cli app that will live on Linux devices. Can be installed on a few shells.
BreizhHardware 2026-05-07 00:30:13 +02:00
Author
Owner

@Gamedirection commented on GitHub (Jan 17, 2026):

If you would like to include it, I can submit a pull request. Please let me know if there is a more suitable directory for storing it.

<!-- gh-comment-id:3764391136 --> @Gamedirection commented on GitHub (Jan 17, 2026): If you would like to include it, I can submit a pull request. Please let me know if there is a more suitable directory for storing it.
Author
Owner

@binwiederhier commented on GitHub (Jan 18, 2026):

I'm happy to add it to the integrations and projects page: https://docs.ntfy.sh/integrations/
Feel free to create a PR to add it to that.

ntfy already has a CLI, but I'm glad you many a small one that fits your needs.

<!-- gh-comment-id:3764548246 --> @binwiederhier commented on GitHub (Jan 18, 2026): I'm happy to add it to the integrations and projects page: https://docs.ntfy.sh/integrations/ Feel free to create a PR to add it to that. ntfy already has a CLI, but I'm glad you many a small one that fits your needs.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/ntfy#1095
No description provided.