Skip to content

Commit

Permalink
add some updates to the readme (#6)
Browse files Browse the repository at this point in the history
  • Loading branch information
Mike Zrimsek authored Apr 20, 2024
1 parent 36cfef7 commit e6c8667
Show file tree
Hide file tree
Showing 3 changed files with 44 additions and 14 deletions.
58 changes: 44 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,32 @@
# NTFY Workbench

A simple web app to manage NTFY topics wtih tags.
A simple web app to manage [ntfy.sh](https://ntfy.sh) topics. It allows you to configure topics so that you can view by topic or by tag. Tagging allows you to group related topics together to make it easier to get a quick overview of what's happening for a particular project or area of interest. You can have as many tags as you want for a topic so you can group them pretty much however you would like.

## Running the app
By Topic View
![By Topic View](./docs/messages-by-topic.png)

### Locally
By Tag View
![By Tag View](./docs/messages-by-tag.png)

1. Install dependencies
## Features

```shell
npm install
```
- View topics by tag
- View topics by topic
- Message counter for topics and tags
- Mobile friendly view (probably not perfect but it works pretty decently)

## Planned Features

2. Create a `config.json` file and drop it in the config folder. See the example below.
- Message acknowledgements (mark as read)
- Ability to configure a webhook for a topic or tag with potential filtering by message contents
- Ability to configure everything from the UI (currently requires a config file)
- Maybe some other shit but I work on this in my free time so bear with me

## Running the app

#### Example config.json
Using Docker is the easiet way to run the app, but you can also build it locally.

### Example config.json

```json
{
Expand All @@ -41,13 +53,15 @@ npm install
}
```

3. Start the app
### Docker

```shell
npm run dev
```
#### Docker Run

### Docker
1. Create a `config.json` file and drop it in the desired directory. See the example above.

2. Run `docker run -p 3000:3000 -v /path/to/config:/app/config ghcr.io/mzrimsek/ntfy-workbench:latest`

3. Access the app at `http://localhost:3000`

#### Docker Compose

Expand Down Expand Up @@ -88,3 +102,19 @@ docker run -p 3000:3000 -v /path/to/config:/app/config ntfy-workbench
```

5. Access the app at `http://localhost:3000`

### Locally

1. Install dependencies

```shell
npm install
```

2. Create a `config.json` file and drop it in the config folder. See the example above.

3. Start the app

```shell
npm run dev
```
Binary file added docs/messages-by-tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/messages-by-topic.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e6c8667

Please sign in to comment.