A simple terminal tool for bark

简体中文 · English· Report Bug · Request Feature

• About the Project
• Getting Started
  • Installation
    • Build Source Code
    • Download Release
• Usage
  • Settings
  • Commands
  • Flags
• Release
• Contributing
• License
• Contact

Bark is a simple but sharp iOS App which allows you to simply send Get/Post request to push customed notifications to your iPhone.

This project allows you to use basicly terminal to use bark to push customed notifications!

Simple Like this: bark-cli -t="Hello-Title" -b="Hello-body" bark

And notice this project is developed by Golang, so you can use this application for any platform(Mac, Windows, Linux and so on)

More infomation about Bark:

• Bark
• bark-server

⭐ Star this project if you enjoy this application;

✊ Pull requests for better ideas;

❓ Leave a issue for more questions;

You can build Source code by yourself.

Before doing so, make sure that you have installed Golang >= v1.12.

Do following steps to build a stardard go-modules project

1. Clone this repository

git clone [email protected]:JasonkayZK/bark-cli.git

2. Build the source code

go build

3. Install the source code(this with copy the binary file to your SYSTEM $PATH)

go install

4. Test Installation

$ bark-cli
NAME:
   bark-cli - A simple cli for bark

USAGE:
   bark-cli [global options] command [command options] [arguments...]

VERSION:
   1.0.0
......

By type bark-cli in your terminal, its will show the helper as above;

Then, your installation is finished:smile:

Or, Your can Use make command to build the binary file:

# build all platform binary file, include mac, linux and win
$ make 
or
$ make all

# build mac only
$ make build-mac

# build linux only
$ make build-linux

# build windows only
$ make build-win

the binary file will be generated under bin/{platform}/bark-cli

Your may need to copy the binary file under your SYSTEM $PATH, such as:

• Win: C:\Windows\System32
• Linux/Unix: /usr/local/bin

For more information about make command, see: Makefile

Download the corresponding built file at Releases

Then Copy the binary file under your SYSTEM $PATH, such as:

• Win: C:\Windows\System32
• Linux/Unix: /usr/local/bin

Then type the command bark-cli, to make sure the program is installed:

$ bark-cli
NAME:
   bark-cli - A simple cli for bark

USAGE:
   bark-cli [global options] command [command options] [arguments...]

VERSION:
   1.0.0
......

Your installation is done after seen information above:smile:

To use bark, your need to config the meta data such as: host, port, key, ...

Simply, you can use bark-cli config set to generate or update a setting file at $HOME/bark-cli/bark-cli/json, such as:

$ bark-cli --host=your_host_address -p=8080 -k=xxxxxxxx config set
config updated at: C:\Users\Administrator\bark-cli\bark-cli.json

More simple, if you use the default host(https://api.day.app) and port(443) as Bark provided, you can generate your config file like this:

$ bark-cli -k=123 config set
config updated at: C:\Users\Administrator\bark-cli\bark-cli.json

To update the setting file, just use bark-cli config set as below:

$ bark-cli config list
{
    "port": 8080,
    "host": "your_host_address",
    "key": "xxxxxxxx"
}

$ bark-cli -p=123 config set
config updated at: C:\Users\Administrator\bark-cli\bark-cli.json

$ bark-cli config list
{
    "port": 123,
    "host": "your_host_address",
    "key": "xxxxxxxx"
}

Simply you can list your settings contents at $HOME/bark-cli/bark-cli/json by typing:

$ bark-cli config list
{
    "port": 8080,
    "host": "your_host_address",
    "key": "xxxxxxxx"
}

This setting file will be loaded when you execute a command.

Instead of using default setting file, you can use flags to set the settings in current execution, such as:

$ bark-cli -p=port_num --host=host_address -k=xxxxx [other flags...] command

Even you can load the settings from other setting files by using -f or --file:

$ bark-cli -f=./bark-cli.json [other flags...] command

Priority: file > flags > default

Notice that default config file will be load before execute the command, then flags override the default settings, and -f param override the flags in the end;

So, if you execute like this:

$ bark-cli -p=8888 --host=www.host.com -k=123333 -f=./bark-cli.json [other flags] command

The setting is always:

{
   "port": 8888,
   "host": "www.host.com",
   "key": "123333"
}

All commands is in the list below:

There are plenty global flags you can set in execution:

For more information, just type bark-cli -h for help!

Almost all flags are corresponding to the origin Bark Application

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.

Jasonkay - Blog - [email protected]

Project Link: https://github.com/JasonkayZK/bark-cli