https://github.com/dreddick-home/mixcloudclient
A simple CLI for interacting with mixcloud
https://github.com/dreddick-home/mixcloudclient
go mixcloud
Last synced: 5 months ago
JSON representation
A simple CLI for interacting with mixcloud
- Host: GitHub
- URL: https://github.com/dreddick-home/mixcloudclient
- Owner: dreddick-home
- License: apache-2.0
- Created: 2020-08-05T09:54:54.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-08-17T07:38:51.000Z (almost 6 years ago)
- Last Synced: 2024-06-21T13:50:44.499Z (about 2 years ago)
- Topics: go, mixcloud
- Language: Go
- Homepage:
- Size: 260 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mixcloudclient
A simple CLI for interacting with Mixcloud
## Description
This is a utility for interacting with [Mixcloud](https://www.mixcloud.com).
The project was started to find an easier way to search Mixcloud for content.
### Search
The search function uses go routines to query the Mixcloud API quickly using a search term. Client-side filters can be applied to exclude or include items from the results.
## Usage
Use the following syntax to run mixcloudclient commands from your terminal window:
```console
$ mixcloudclient [command] [flags]
```
### Commands
#### Search
```
Flags:
-e, --excludes strings Must exclude term, multiple items accepted.
-h, --help help for search
-i, --includes strings Must include term, multiple items accepted.
-m, --max int32 Max results (in 100s). Default 20.
-t, --term string Search Term
-w, --workers int32 The max number of concurrent workers. Defaults to number of cores of system. (default 8)
```

## Docker
```console
$ docker run dreddick/mixcloudclient:v0.0.2 search -t 'nick warren' -i 1995
```
## Install
### Build and Install the Binaries from Source
#### Prerequisite Tools
* Git
* Go
#### Fetch from GitHub
```console
$ git clone https://github.com/dreddick-home/mixcloudclient.git
$ cd mixcloudclient
$ go build -o /usr/local/bin/mixcloudclient
```
### Releases
See https://github.com/dreddick-home/mixcloudclient/releases