|
2 | 2 | <img src="https://suyashkumar.com/assets/img/terminal_large.png" width="80"> |
3 | 3 | <h3 align="center">GitHub Release Downloader</h3> |
4 | 4 | <p align="center">Download latest GitHub release binaries (for your OS/arch) using <code>wget</code> or <code>curl</code></p> |
5 | | - <p align="center"><code>wget --content-disposition https://bin.suyash.io/suyashkumar/ssl-proxy</code></p> |
6 | | - <p align="center"> <a href="https://goreportcard.com/report/github.com/suyashkumar/bin"><img src="https://goreportcard.com/badge/github.com/suyashkumar/bin" alt=""></a> <a href="https://godoc.org/github.com/suyashkumar/bin"><img src="https://godoc.org/github.com/suyashkumar/bin?status.svg" alt=""></a> |
| 5 | + <p align="center"><code>wget --content-disposition https://getbin.io/suyashkumar/ssl-proxy</code></p> |
| 6 | + <p align="center"> <a href="https://goreportcard.com/report/github.com/suyashkumar/getbin"><img src="https://goreportcard.com/badge/github.com/suyashkumar/getbin" alt=""></a> <a href="https://godoc.org/github.com/suyashkumar/getbin"><img src="https://godoc.org/github.com/suyashkumar/getbin?status.svg" alt=""></a> |
7 | 7 | </p> |
8 | 8 | </p> |
9 | 9 |
|
10 | 10 | ## Overview |
11 | | -This is a simple server (deployed @ https://bin.suyash.io) that makes it easy to download the latest binary associated with _any GitHub repo release_ using regular old `wget` and `curl`. It attempts to use your User-Agent to fetch the right GitHub release asset for your OS/arch, but also lets you provide query parameters to specify OS/arch, and optionally uncompress the release artifact on the fly. |
| 11 | +This is a simple server (deployed @ https://getbin.io) that makes it easy to download the latest binary associated with _any GitHub repo release_ using regular old `wget` and `curl`. It attempts to use your User-Agent to fetch the right GitHub release asset for your OS/arch, but also lets you provide query parameters to specify OS/arch, and optionally uncompress the release artifact on the fly. |
12 | 12 |
|
13 | 13 | I mostly just built this as a way to distribute my software binaries easily without dealing with `brew`, `npm`, etc (though they certainly have their advantages & trust). I can just give my users a one line download link that will always get them the latest released binary for their platform, and _all I have to do is just update GitHub releases like I normally do_. |
14 | 14 |
|
15 | | -Basic functionality currently exists (with some assumptions, see below), but this is still a work in progress with many improvements forthcoming. This currently will work as expected with all of my repos/releases. |
| 15 | +Basic functionality currently exists (with some assumptions, see below), but this is still a work in progress with many improvements forthcoming. This currently will work as expected with all of __my__ repos/releases. |
16 | 16 |
|
17 | 17 | ## Usage |
18 | 18 | Let's say you wanted to get the __latest__ [`suyashkumar/ssl-proxy`](https://github.com/suyashkumar/ssl-proxy) binary for your OS/arch. You simply: |
19 | 19 | ```sh |
20 | | -wget -qO- https://bin.suyash.io/suyashkumar/ssl-proxy | tar xvz |
| 20 | +wget -qO- https://getbin.io/suyashkumar/ssl-proxy | tar xvz |
21 | 21 | ``` |
22 | 22 | or with `curl` you usually must specify your os (since it is not included in the User-Agent): |
23 | 23 | ```sh |
24 | | -curl -LJ "https://bin.suyash.io/suyashkumar/ssl-proxy?os=darwin" | tar xvz |
| 24 | +curl -LJ "https://getbin.io/suyashkumar/ssl-proxy?os=darwin" | tar xvz |
25 | 25 | ``` |
26 | 26 | ### Use with any* GitHub repo |
27 | | -The generalized request format is `GET https://bin.suyash.io/GITHUB_USERNAME/GITHUB_REPO`. See section below for assumptions. |
| 27 | +The generalized request format is `GET https://getbin.io/GITHUB_USERNAME/GITHUB_REPO`. See section below for assumptions. |
28 | 28 |
|
29 | 29 | Let's say we wanted the latest distribution of [`goreleaser/goreleaser`](https://github.com/goreleaser/goreleaser/): |
30 | 30 | ```sh |
31 | | -wget -qO- https://bin.suyash.io/goreleaser/goreleaser | tar xvz |
| 31 | +wget -qO- https://getbin.io/goreleaser/goreleaser | tar xvz |
32 | 32 | ``` |
33 | 33 |
|
34 | 34 | Generally, the server software attempts to detect your OS (and in the future, architecture) automatically from your `User-Agent`, but also allows you to specify your own intentions as seen with `curl` above. We're piping into `tar` here because the original release assets are compressed, but you can also uncompress on the fly (see below) |
35 | 35 |
|
36 | 36 | #### Uncompress on the fly |
37 | 37 | If you want to not bother with piping into tar or zip as above, the server can decompress on the fly to serve you the binary (assuming it is the only file in the archive): |
38 | 38 | ```sh |
39 | | -wget --content-disposition "https://bin.suyash.io/suyashkumar/ssl-proxy?uncompress=true" |
| 39 | +wget --content-disposition "https://getbin.io/suyashkumar/ssl-proxy?uncompress=true" |
40 | 40 | ``` |
41 | 41 |
|
42 | 42 | If your release asset is __not compressed__, you can simply: |
43 | 43 | ```sh |
44 | | -wget --content-disposition "https://bin.suyash.io/suyashkumar/ssl-proxy" |
| 44 | +wget --content-disposition "https://getbin.io/suyashkumar/ssl-proxy" |
45 | 45 | ``` |
46 | 46 | or |
47 | 47 | ```sh |
48 | | -curl -LOJ "https://bin.suyash.io/suyashkumar/ssl-proxy?os=darwin" |
| 48 | +curl -LOJ "https://getbin.io/suyashkumar/ssl-proxy?os=darwin" |
49 | 49 | ``` |
50 | 50 |
|
51 | 51 |
|
|
0 commit comments