v2.0.9: add youtubeHLS option

v2.0.9: update with api, specify tests, errors descriptions

v2.0.7: add error description mapping

cobalt errors are now automatically mapped to it's respective description. Added more tests

v2.0.6: re-added instance listing

Instance listing powered by @KwiatekMiki.

v2.0.4: Added support for Api Keys

Now almost all servers are likely to have api keys enabled, just request one from the server admin.

Instance tracker has been disabled, as it is returning 503.

v2.0.2: Add support for Youtube playlists

What's new

• Youtube playlists are now supported (using https://codeberg.org/kwiat/playlist/src/branch/main/README.md#api api);
• Added private genericHttpRequest to avoid code repetition.

v2.0.1: update api url

Just changed the api url, should work for everyone now. Thanks to @hyperdefined for allowing me to use their api.

v2.0.0: gobalt version 2 is live!

Hello! It's been quite some time, huh?
Today, cobalt has updated it's API, and we have updated the library too! Here's what changed (a lot, breaking changes even)

Additions:

• Proxy (bool): Now Cobalt can proxy files for you, default is false;
• AudioBitrate (int): You can changed audio bitrate downloaded from cobalt;
• Mode (downloadMode): Now you don't need to set AudioOnly or VideOnly to download only the audio or video. Either Auto, Audio or Mute;
• File name is now returned from the api directly.

Changes:

• Default API url is https://beta.cobalt.canine.tools has there no public official instance api anymore;
• Youtube dubbed audio language is now on Settings struct;
• Renamed AudioFormat, FilenameStyle, TikTokFullAudio, TwitterConvertGif, VideoQuality, YoutubeDubbedAudio, YoutubeDubbedLanguage and YoutubeDubbedLanguage.
• You can use your own http.Client now.

Default settings

New default options:

• Url: "" (empty);
• YoutubeVideoFormat: H264;
• VideoQuality: 1080;
• AudioFormat: Best;
• AudioBitrate: 128;
• FilenameStyle: Basic;
• TwitterConvertGif: true;
• Mode: Auto;
• YoutubeDubbedLanguage: en;

Run()

Now it only checks if the url was set or not.;
If it fails it will return the cobalt.error.code;

Cobalt instance list

Updated a lot of things, now it returns only v10.0.0 or higher cobalt instances, supported services, score (benchmark), protocol and trust

Useragent

Now the useragent is gobalt/2.0.0 (+https://github.com/lostdusty/gobalt/v2; go/go1.23.1; windows/amd64 (changes based on the library version, go version, os and arch)

Documentation

Added more documentation to the code, should be easier to understand now.

v1.1.0: only fetch <=v7.15 instances

Gobalt v1.1.0 is here!

What's new:

• Now it will only fetch v7.15 and lower cobalt instances due of breaking changes with the new cobalt api.
  • The new cobalt api can't be used with 3rd party clients, but the old api will be supported for some time;
  • The v1 version of this library will be updated until 31 / December / 2024. We recommend switching to v2.

v1.0.8: media parsing

give link, get size, name and mime type

v1.0.7: update api changes

v1.0.7

• Update api changes;
• Removed VimeoDash option (imputnet/cobalt@0ca393e);
• Added tiktokH265 option (imputnet/cobalt@8f5eec0);