A simple terminal tool for bark

简体中文 · English· 报告 Bug · 提交新特性

• 关于本项目
• 用前须知
  • 安装
    • 编译源代码安装
    • 下载发行包
• 如何使用
  • 应用配置
  • 命令
  • 标志位
• 发行版本
• 贡献代码
• 协议
• 联系我

Bark是一个简单但却很犀利的iOS应用，它允许你简单地发送Get/Post请求，将定制的通知推送到你的iPhone上。

这个项目允许您使用基本终端来使用Bark推送自定义通知！

像这样简单的命令即可推送通知：bark-cli -t="Hello Title" -b="Hello body" bark

由于这个项目是由Golang开发的，所以您可以在任何平台（Mac、Windows、Linux等）上使用这个应用程序

更多关于Bark的信息：

• Bark
• bark-server

⭐ 给本项目一个Star如果你觉得用得爽；

✊ 通过Pull Request给本项目提供新的特性；

❓ 在Issue区提出你的问题；

您可以自己构建源代码。

执行此操作之前，请确保已安装Golang>=v1.12

执行以下步骤来构建stardard go模块项目：

1. Clone本仓库

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

2. 编译源代码

go build

3. 安装源代码（这会将编译好的二进制文件复制到SYSTEM $PATH目录下）

go install

4. 测试安装

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

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

VERSION:
   1.0.0
......

通过在终端中键入bark cli，若显示如上所述的帮助信息，说明安装成功:smile:

或者，你也可以使用“make”命令生成二进制文件：

# 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

二进制文件将在bin/{platform}/bark-cli下生成；

编译完成后还需要复制二进制文件到系统环境变量$PATH下，例如：

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

有关“make”命令的详细信息，请参见：Makefile

直接下载对应平台的二进制文件：Releases

然后将下载的二进制文件放在系统环境变量$PATH下，例如：

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

然后键入命令bark cli，来确保程序已正确安装：

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

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

VERSION:
   1.0.0
......

看到上面的提示说明安装成功:smile:

要使用Bark，您需要配置元数据，例如：主机、端口、密钥等

简单地说，可以使用bark-cli config set命令，生成或更新配置文件$HOME/bark-cli/bark-cli.json，例如：

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

更简单的是，如果使用默认主机(https://api.day.app)和Bark提供的端口（443），则可以使用下面的命令生成配置文件：

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

要更新设置文件，只需使用bark-cli config set，如下所示：

$ 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"
}

只需键入下面的命令即可列出在$HOME/bark-cli/bark-cli.json中的设置内容：

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

每次执行命令前将会首先加载此配置文件。

您可以使用标志位来设置本次执行命令的配置，而不是使用默认的配置文件，例如：

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

或者你也可以通过 -f or --file来指定通过其他配置文件传入配置信息

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

优先级： 指定文件 > 标志位 > 默认配置文件

注意，在执行命令之前将加载默认配置文件，然后指定的标志位会覆盖默认设置，然后-f覆盖标志位；

所以当你执行类似于下面的命令时：

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

实际的配置信息如下：

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

下面是本应用中的命令：

在执行命令时可以设置许多全局标志：

通过 bark-cli -h 命令查看更多信息！

几乎所有标志都对应于：Bark应用

贡献使开源社区成为一个学习、激励和创造的绝佳场所。

你对本项目所作的任何贡献都是非常感谢的:heart:。

1. Fork本项目
2. 检出到新的分支 (git checkout -b feature/AmazingFeature)
3. 提交你的修改 (git commit -m 'Add some AmazingFeature')
4. 推送你的提交 (git push origin feature/AmazingFeature)
5. 开启一个新的Pull Request

根据MIT许可协议发行。详细信息，请参见LICENSE。

Jasonkay - Blog - [email protected]

项目地址: https://github.com/JasonkayZK/bark-cli