Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lostdusty/cobalt
Unofficial cobalt command line client made in go.
https://github.com/lostdusty/cobalt
cli cli-app cobalt cobalt-tools download-videos downloader go golang instagram reddit soundcloud terminal-based twitter youtube youtube-downloader
Last synced: 27 days ago
JSON representation
Unofficial cobalt command line client made in go.
- Host: GitHub
- URL: https://github.com/lostdusty/cobalt
- Owner: lostdusty
- License: mit
- Created: 2024-01-25T15:51:01.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-04-29T01:03:46.000Z (6 months ago)
- Last Synced: 2024-04-29T13:45:46.209Z (6 months ago)
- Topics: cli, cli-app, cobalt, cobalt-tools, download-videos, downloader, go, golang, instagram, reddit, soundcloud, terminal-based, twitter, youtube, youtube-downloader
- Language: Go
- Homepage:
- Size: 58.6 KB
- Stars: 25
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
cobalt-cli
[](#downloading)
[](https://discord.gg/pQPt8HBUPu)
[](https://github.com/wukko/cobalt?tab=readme-ov-file#supported-services)
Unofficial [cobalt](https://cobalt.tools) command line client made in go. cobalt-cli uses [gobalt library](https://github.com/princessmortix/gobalt) for communication between your machine <-> cobalt servers.
- [Features](#features)
- [Download](#downloading)
- [Roadmap](#roadmap)
- [Usage](#usage)
- [Compiling](#compiling)
## Features
- Get directly link from the service cdn (if possible);
- More than 15 services supported;
- JSON output using the flag `-j` or `--json`;
- Option to check status of cobalt servers;
- Use custom cobalt instances (see https://instances.hyper.lol);
- Get dubbed youtube audio.
## Download
| **Platform/OS** | **Download link** |
|-----------------|--------------------|
| Windows | [**x64**](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-windows-amd64.zip) / [x86](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-windows-386.zip) / [arm](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-windows-arm.zip) |
| Linux | [**x64**](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-linux-amd64.tar.gz) / [x86](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-linux-386.tar.gz) / [arm64](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-linux-arm64.tar.gz) |
| Mac | [Intel](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-darwin-amd64.tar.gz) / [**M1, M2, M3**](https://github.com/princessmortix/cobalt/releases/latest/download/cobalt-darwin-arm64.tar.gz) |
You can also check the [releases page](https://github.com/princessmortix/cobalt/releases/latest) to download the latest version according to your platform.
Alternatively, if you have Go installed, you can use `go install github.com/lostdusty/cobalt@latest` to install to your machine.
## Roadmap
Planned features for cobalt-cli:
- [x] Json output;
- [ ] Time expiration for the returned url.
- [ ] Option to save file to the current/custom folder, likely `-s` flag;
- [ ] Display progress bar to track download progress (when supported by cobalt).
- [ ] Hability to use custom downloader program (wget, curl, got, etc);
- [ ] Translations.
## Usage
cobalt-cli has two subcommands:
- download: downloads something using cobalt
- instances: lists all known cobalt instances
```
Usage: cobalt
Commands:
download - Use this command to download something.
instances - Use this command to view stats about other cobalt instances.
Error: No command was provided. Please specify a command.
```
### Download
```
usage: cobalt download [-h|--help] [-u|--url ""] [-c|--video-codec
(av1|vp9|h264)] [-q|--video-quality
(144|240|360|480|720|1080|1440|2160)] [-f|--audio-format
(opus|ogg|wav|mp3|best)] [-p|--filename-pattern
(basic|pretty|nerdy|classic)] [-a|--no-video] [-T|--tiktok-h265]
[-t|--full-tiktok-audio] [-v|--no-audio] [-d|--dubbed-audio]
[-m|--metadata] [-g|--gif] [-j|--json] [-s|--status] [-i|--api
""] [-l|--language ""] [-b|--browser]
download something using cobalt
Arguments:
-h --help Print help information
-u --url The url to download using cobalt
-c --video-codec Video codec to be used. Applies only to youtube
downloads. AV1: 8K/HDR, lower support | VP9: 4K/HDR,
best quality | H264: 1080p, works everywhere.
Default: h264
-q --video-quality Quality of the video, also applies only to youtube
downloads. Default: 1080
-f --audio-format Audio format/codec to be used. "best" doesn't
re-encodes the audio. Default: best
-p --filename-pattern File name pattern. Classic:
youtube_yPYZpwSpKmA_1920x1080_h264.mp4 | audio:
youtube_yPYZpwSpKmA_audio.mp3 // Basic: Video Title
(1080p, h264).mp4 | audio: Audio Title - Audio
Author.mp3 // Pretty: Video Title (1080p, h264,
youtube).mp4 | audio: Audio Title - Audio Author
(soundcloud).mp3 // Nerdy: Video Title (1080p, h264,
youtube, yPYZpwSpKmA).mp4 | audio: Audio Title -
Audio Author (soundcloud, 1242868615).mp3. Default:
pretty
-a --no-video Downloads only the audio, and removes the video.
Default: false
-T --tiktok-h265 Downloads TikTok videos using h265 codec. Default:
false
-t --full-tiktok-audio Download the original sound used in a tiktok video.
Default: false
-v --no-audio Downloads only the video, without audio, when
possible. Default: false
-d --dubbed-audio Downloads youtube audio dubbed, if present. Change
the language using -l . Default:
false
-m --metadata Disables file metadata. Default: false
-g --gif Convert twitter gifs to .gif. Default: true
-j --json Output to stdout as json
-s --status Check status of the selected cobalt server, prints
and exits. All other options will be ignored, except
-j | --json. Default: false
-i --api Change the cobalt api url used. See others instances
in https://instances.hyper.lol. Default:
https://api.cobalt.tools
-l --language Downloads dubbed youtube audio according to the
language set following the ISO 639-1 format. Only
takes effect if -d was passed as an argument.
Default: en
-b --browser Downloads the requested media in your browser.
Default: false
```
### Instances
```
usage: cobalt instances [-h|--help] [-j|--json]
get the list of cobalt instances
Arguments:
-h --help Print help information
-j --json Output to stdout as json
```
## JSON Output
Documentation for the json output of cobalt-cli.
### Download
All json output from the download subcommands follows this format:
```json
{
"error": bool,
"message": "string",
"urls": ["string1", "string2", ...]
}
```
Where:
| **name** | **type** | **info** | **example** |
|---|---|---|---|
| error | bool | true if something went wrong | "error":true |
| message | string | return error messages, otherwise "ok" | "message":"cobalt error: i couldn't connect to the service api. maybe it's down, or cobalt got blocked" |
| urls | []string | array of urls returned by the service, query scaped | "urls":["https%3A%2F%2Fus3-co.wuk.sh%2Fapi%2Fstream%3Ft%3D6kS3Xr97CAoqvPlBYX0r8%26e%3D1713849463113%26h%3DNHPfrLZ-BJejEnH2orowNy0zzTlVXSYw77RBhzIf0MU%26s%3DxvmTt9DTNl4wLslkfYfCUv6UDIPOTv9iZutl7ENM_dc%26i%3DuX7INLhsbzzofNxZaw6o7g"] |
### Instances
Returns almost the original json from [https://instances.hyper.lol/](https://instances.hyper.lol/instances.json), except we add two extra keys: error and message, just like above.
Example JSON:
```json
[{"error":false,"message":"success!"},[{"version":"7.12.6","commit":"50a98c8","branch":"current","name":"us3","url":"co.wuk.sh","cors":1,"startTime":"1713626380117","FrontendUrl":"cobalt.tools","ApiOnline":true,"FrontEndOnline":true},{"version":"7.12.6","commit":"50a98c8","branch":"current","name":"us-east","url":"cobalt.canine.tools","cors":1,"startTime":"1713837765475","FrontendUrl":"cobalt.canine.tools","ApiOnline":true,"FrontEndOnline":true},{"version":"7.12.6","commit":"50a98c8","branch":"current","name":"us-mw","url":"coapi.selfstacked.com","cors":1,"startTime":"1713626820678","FrontendUrl":"co.selfstacked.com","ApiOnline":true,"FrontEndOnline":true}]]
```
Error example:
```json
{"error":true,"message":"Get \"https://instances.hyper.lol/instances.json\": dial tcp: lookup instances.hyper.lol: no such host"}
```
## Compiling
Make sure you have the lastest go compiler. [Download it here](https://go.dev/dl).
Easy as:
1. Clone this repository.
2. On the root of this repository, run `go mod tidy`. This will download this project dependencies.
3. To run the application, use `go run .`. To compile, run `go build`.
To add additional Windows metadata, you'll need:
- [go-winres](https://github.com/tc-hib/go-winres), follow the install instructions there
Then run `go-winres make` on the root of this repository, it will create two .syso files.
After that, building with `go build` will automatically embed these files on the Windows executable.
## Other projects
Check out too:
- [tobalt, cobalt in typescript](https://github.com/tskau/tobalt)
- [tcobalt, cobalt cli in rust](https://github.com/khyerdev/tcobalt)
# About & Thanks
- [cobalt](https://github.com/imputnet/cobalt) made by [wukko](https://github.com/wukko) && [jj](https://github.com/dumbmoron), cool people;
- [argparse](https://github.com/akamensky/argparse), for handling args;
- Icon made by [me](https://lostdusty.com.br);
- You, for using my application!