cobalt-7/README.md

cobalt

Best way to save content you love.

co.wukko.me

What's cobalt?

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

It preserves original media quality so you get best downloads possible (unless you change that in settings).

Supported services

Video and audio

• bilibili.com
• douyin
• Reddit
• TikTok
• Tumblr
• Twitter
• YouTube (with HDR support)

Only video

• Vimeo
• VK

Only audio

• YouTube Music

Translations

• Spanish: @adrigoomy
• French: @lexito-o
• Indonesian: @LyfeV
• Polish: @hexandcube

How you can help cobalt speak your language

Take English or Russian localization from this directory and use it as a base for your translation. Then simply make a pull request and it'll be out for everyone upon review!

What you should keep in mind:

• Do NOT use formal language, that's boring and lame. Use informal language on all occasions.
• Strings are ALWAYS lowercase unless it's an internal value like {ContactLink} or STRESSED LIKE THIS.
• Keep translations as friendly and fun as possible.
• Word-for-word translations from original language are not valid.
• You can rephrase sentences as long as they keep the same sense.
• You can add wordplays or puns if it feels natural to do so.
• Even though I love cursing, keep that away from translations.
• Always check if there are issues in UI with your localization.
• There's no need to translate ChangelogContentTitle and ChangelogContent, because those are very often changed. You can remove both of them from your translation file.
• Add "(in english)" in translation language to ChangelogLastCommit and ChangelogLastMajor, because those are almost always kept exclusively in English. Remove that phrase if you do translate major update changelog.
• Be nice.

TO-DO

Services

• niconico support
• Instagram support
• SoundCloud support
• Quality switching for bilibili
• Find a way to get TikTok videos without a watermark
• Add an option to keep watermark on TikTok videos

Other

• Remake video quality picking (do it more like I did in Vimeo module)
• Add support for emoji in localization
• Language picker in settings
• Make cobalt fully PWA compatible (add a service worker)

Host an instance yourself

Code might be a little 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
• ytdl-core

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

This is my passion project, so update scheduele depends solely on my motivation. Don't expect any consistency in that.

Third party stuff

Fluent Emoji by Microsoft.

License

cobalt is under AGPL-3.0.