Skip to content

Commit 4a53caf

Browse files
committed
Add README
1 parent 7e3a89f commit 4a53caf

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

README.md

+59
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
<div align="center">
2+
3+
<img src="https://s.electerious.com/images/ackee-bitbar/icon.png" title="Ackee" alt="Ackee logo" width="128">
4+
5+
# ackee-bitbar
6+
7+
[![Donate via PayPal](https://img.shields.io/badge/paypal-donate-009cde.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CYKBESW577YWE)
8+
9+
[BitBar](https://github.com/matryer/bitbar) plugin that displays an overview of your current Ackee stats in the macOS menu bar.
10+
11+
<br/>
12+
13+
![The Ackee plugin in a menu bar](https://s.electerious.com/images/ackee-bitbar/readme.png)
14+
15+
</div>
16+
17+
## 🚀 Get started
18+
19+
### 1) Grab the project
20+
21+
```sh
22+
git clone https://github.com/electerious/ackee-bitbar.git
23+
```
24+
25+
### 2) Create a configuration
26+
27+
```sh
28+
cd ackee-bitbar
29+
vim .env
30+
```
31+
32+
```
33+
ACKEE_ENDPOINT=https://example.com/api
34+
ACKEE_TOKEN=5c5411b0-ef80-425b-8e80-e8c4a76fcad6
35+
```
36+
37+
### 3) Add the plugin to BitBar
38+
39+
```
40+
ln -s index.js ../BitBar/Plugins/Enabled/ackee-bitbar.5m.js
41+
```
42+
43+
## 💭 FAQ
44+
45+
### The plugin shows `env: No such file or directory`
46+
47+
BitBar [requires that the script contains a shebang](https://github.com/matryer/bitbar#tested-languages) that points to your node binary. `ackee-bitbar` defaults to `/usr/local/bin/node`. You might need to adjust the path at the top of the `index.js`.
48+
49+
### Where can I get my Ackee token?
50+
51+
There's currently no way to create a token in the interface of Ackee, but you can use the API to [generate a new token](https://github.com/electerious/Ackee/blob/master/docs/API.md#creating-a-token).
52+
53+
### How long is the token valid?
54+
55+
The generated token is only valid for a limited time. Adjust the [TTL](https://github.com/electerious/Ackee/blob/master/docs/Options.md#ttl) option of your Ackee instance to stay signed in.
56+
57+
### Is is possible to adjust the refresh interval?
58+
59+
[Sure](https://github.com/matryer/bitbar#using-symlinks). Simply change the `5m` in the symlink filename to `1h`, `1m`, `30s` or the refresh timing of your choice.

0 commit comments

Comments
 (0)