save what you love
Find a file
2023-03-10 00:45:07 +06:00
.github Create FUNDING.yml 2023-02-16 16:04:22 +06:00
docs updated variables for vquality in api docs 2023-02-26 23:50:57 +06:00
src oops 2023-03-10 00:45:07 +06:00
.deepsource.toml deepsource config update 2023-02-13 20:39:09 +06:00
.gitignore 5.2 2023-03-10 00:41:17 +06:00
crowdin.yml Update Crowdin configuration file 2022-09-03 17:37:22 +06:00
jsconfig.json basically new readme and more languages 2022-08-01 21:48:37 +06:00
LICENSE changed license from gpl3.0 to agpl3.0 2022-07-21 16:36:22 +06:00
package.json 5.2 2023-03-10 00:41:17 +06:00
README.md 5.1 2023-02-26 22:49:25 +06:00

cobalt

Best way to save content you love.

Live: co.wukko.me

cobalt logo with repeated logo pattern background

Crowdin DeepSource DeepSource

What's cobalt?

cobalt is a social media downloader with zero bullshit. It's friendly, efficient, and doesn't bother you with shock ads or privacy invasion "consent" popups.

It tries to preserve original media quality, and in most cases you get best quality possible (you can set your preferences in settings).

Supported services

Service Video + Audio Only audio Additional features
Twitter Ability to save multiple videos/GIFs from a single tweet.
Twitter Spaces Audio metadata.
YouTube & Shorts Support for 8K, 4K, HDR, and high FPS videos. Audio metadata & dubs. h264/av1/vp9 codecs.
YouTube Music Audio metadata.
Reddit GIFs and videos.
TikTok & douyin Video downloads with or without watermark; image slideshow downloads without watermark.
SoundCloud Audio metadata, downloads from private links.
bilibili.com
Tumblr
Vimeo
VK Videos & Clips

cobalt API

cobalt has an open API that you can use for free. It's pretty straightforward to use, check out the docs and see for yourself.

How to contribute translations

You can translate cobalt to any language you want on cobalt's crowdin. Feel free to ignore QA errors if you think you know better. If you don't see a language you want to translate cobalt to, open an issue, and I'll add it to crowdin.

Translation guidelines:

  • Avoid formal language. Leave it for big and classy tech companies. Use informal language wherever possible.
  • Strings are ALWAYS stylized as lowercase unless it's STRESSED LIKE THIS or is an internal value like {ContactLink}.
  • Keep translations lively, friendly, and fun. Translate strings as if the user was your buddy.
  • Automatic translations from original language are not valid, and will be ignored.
  • You can (and should) rephrase sentences as long as they keep the same point, if you think it'd be better that way.
  • You can add wordplays or puns if it feels natural to do so.
  • Even though I love cursing, keep that to minimum in translations, and do NOT use any offensive words.
  • Check if there are issues in UI with your localization, and optimize it accordingly, or open an issue.
  • Add "(in english)" translated to your language at the end of ChangelogLastCommit, ChangelogLastMajor, and ChangelogOlder. Those are always kept exclusively in English (for now), due to how often changelog changes.
    • Sample translation to Russian: "ChangelogLastCommit": "последний коммит (на английском)"
  • Be nice.

Host an instance yourself

You might find cobalt's source code a bit messy, but I do my best to improve it with every commit.

Requirements

  • Node.js 14.16 or above
  • git

npm modules

  • cors
  • dotenv
  • esbuild
  • express
  • express-rate-limit
  • ffmpeg-static
  • got
  • node-cache
  • url-pattern
  • xml-js
  • youtubei.js

Setup script installs all needed npm dependencies, but you have to install Node.js and git yourself.

  1. Clone the repo: git clone https://github.com/wukko/cobalt
  2. Run setup script and follow instructions: npm run setup
  3. Run cobalt via npm start
  4. Done.

Disclaimer

cobalt is my passion project, so update release schedule depends solely on my motivation, free time, and mood. Don't expect any consistency in that.

License

cobalt is under AGPL-3.0 license.

Fluent Emoji used in the project is under MIT license.