Skip to content

Commit

Permalink
Add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
richinfante committed Feb 17, 2019
1 parent f4dde79 commit b9bcb18
Show file tree
Hide file tree
Showing 2 changed files with 56 additions and 0 deletions.
56 changes: 56 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# shbar
Shell Scripting + Jobs in your macOS Menu Bar!

_warning: this is alpha quality software. Use at your own risk._

![example screenshot](screenshots/demo.png)

## Known Issues
- Killing the shbar app does not kill child procesess, on restart new ones are created.

## Install
1. Grab the latest release [here](https://github.com/richinfante/shbar/releases)
2. Download and place unzipped `.app` file into `/Applications`

## Setup
In a file named `~/.config/shbar/shbar.json`, add a file using the following structure:

```json
[
{
"titleRefreshInterval" : 120,
"title" : "IP Address",
"mode" : "RefreshingItem",
"titleScript" : {
"bin" : "/bin/sh",
"args" : [
"-c",
"echo IP: $(curl https://api.ipify.org)"
],
"env" : {
"PATH" : "/usr/bin:/usr/local/bin:/sbin:/bin"
}
}
}, {
"autostartJob" : true,
"jobScript" : {
"bin" : "/bin/bash",
"args" : [
"-c",
"ssh user@example.com -nNT -L 8080:localhost:8080"
],
"env" : {
"PATH" : "/usr/bin:/usr/local/bin:/sbin:/bin"
}
},
"title" : "SSH Tunnel",
"mode" : "JobStatus",
"reloadJob" : false
}, {
"mode" : "ApplicationQuit",
"title" : "Quit",
"shortcutKey" : "q"
}
]

```
Binary file added screenshots/demo.png
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 b9bcb18

Please sign in to comment.