src | ||
.deepsource.toml | ||
.gitignore | ||
crowdin.yml | ||
jsconfig.json | ||
LICENSE | ||
package.json | ||
README.md |
cobalt
Best way to save content you love.
What's cobalt?
cobalt is social media downloader with zero bullshit. It's friendly, efficient, works on anything with a browser, and doesn't bother you with porn ads or privacy invasion "consent" popups.
It preserves original media quality so you get best downloads possible (unless you change that in settings).
Support status
Service | Video + Audio | Only audio | Additional features |
---|---|---|---|
✅ | ✅ | ||
YouTube | ✅ | ✅ | Supports HDR and high FPS videos |
YouTube Music | ❌ | ✅ | |
✅ | ✅ | ||
TikTok & douyin | ✅ | ✅ | Videos can be downloaded with or without watermark, preference is set by user. |
SoundCloud | ❌ | ✅ | |
bilibili.com | ✅ | ✅ | |
Tumblr | ✅ | ✅ | |
Vimeo | ✅ | ⚒️ | |
VK | ✅ | ⚒️ |
Translations
- Spanish: @adrigoomy (translation is outdated, update needed)
- French: @lexito-o (translation is outdated, update needed)
- Indonesian: @LyfeV (translation is outdated, update needed)
- Polish: @hexandcube
- Ukrainian: Löffel
Other languages may be missing some strings or changes, you can help with updating those!
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 boring big tech companies. Use informal language on all occasions.
- 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 cobalt 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
andChangelogLastMajor
. Those are always kept exclusively in English, due to how often changelog changes.- Example of translation to Russian:
"ChangelogLastCommit": "последний коммит (на английском)"
- Example of translation to Russian:
- 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
- ytdl-core
Setup script installs all needed npm
dependencies, but you have to install Node.js
and git
yourself.
- Clone the repo:
git clone https://github.com/wukko/cobalt
- Run setup script and follow instructions:
npm run setup
- Run cobalt via
npm start
- Done.
Disclaimer
cobalt is my passion project, so new feature release schedule depends solely on my motivation and mood. Don't expect any consistency in that.
License
cobalt is under AGPL-3.0. Fluent Emoji by Microsoft is under MIT.