2022-07-08 18:17:56 +00:00
# cobalt
2022-08-06 15:21:48 +00:00
Best way to save content you love.
2022-08-01 15:48:37 +00:00
2022-08-06 15:21:48 +00:00
[co.wukko.me ](https://co.wukko.me/ )
2022-07-08 18:17:56 +00:00
2022-07-30 09:12:32 +00:00
![cobalt logo ](https://raw.githubusercontent.com/wukko/cobalt/current/src/front/icons/wide.png "cobalt logo" )
2022-07-08 18:17:56 +00:00
2022-08-01 15:48:37 +00:00
## What's cobalt?
2022-08-06 15:21:48 +00:00
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).
2022-07-08 18:17:56 +00:00
2022-08-01 15:48:37 +00:00
## Supported services
2022-07-08 18:17:56 +00:00
2022-08-01 15:48:37 +00:00
### Video
2022-07-08 18:17:56 +00:00
- bilibili.com
2022-08-01 15:48:37 +00:00
- douyin
2022-07-08 18:17:56 +00:00
- Reddit
2022-08-01 15:48:37 +00:00
- TikTok
2022-08-01 17:53:44 +00:00
- Tumblr
2022-08-01 15:48:37 +00:00
- Twitter
2022-08-06 15:21:48 +00:00
- YouTube (with HDR support)
2022-07-08 18:17:56 +00:00
- VK
2022-08-01 15:48:37 +00:00
### Audio
- YouTube
- YouTube Music
## Translations
- Spanish: [@adrigoomy ](https://github.com/adrigoomy )
- French: [@lexito-o ](https://github.com/lexito-o )
- Indonesian: [@LyfeV ](https://github.com/LyfeV )
2022-08-04 18:17:51 +00:00
- Polish: [@hexandcube ](https://github.com/hexandcube )
2022-08-01 15:48:37 +00:00
## How you can help cobalt speak your language
Take English or Russian localization from [this directory ](https://github.com/wukko/cobalt/tree/current/src/localization/languages ) 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.
- Be nice.
2022-07-28 16:03:17 +00:00
## TO-DO
2022-08-01 15:48:37 +00:00
### Services
2022-08-01 17:53:44 +00:00
- [x] Tumblr support
2022-07-30 09:11:25 +00:00
- [ ] niconico support
2022-07-28 16:03:17 +00:00
- [ ] Instagram support
2022-08-01 17:53:44 +00:00
- [ ] SoundCloud support
2022-08-01 15:48:37 +00:00
- [ ] Quality switching for bilibili
2022-08-06 15:21:48 +00:00
- [ ] Find a way to get TikTok videos without a watermark
- [ ] Add an option to keep watermark on TikTok videos
2022-08-01 15:48:37 +00:00
### Other
2022-07-17 12:58:51 +00:00
- [ ] Language picker in settings
2022-07-08 18:17:56 +00:00
- [ ] Make switch buttons in settings selectable with keyboard
2022-08-01 17:53:44 +00:00
- [ ] Option to save audios in formats other than original
2022-08-01 15:48:37 +00:00
- [ ] Make cobalt fully PWA compatible (add a service worker)
- [ ] Make page rendering module more versatile
2022-07-08 18:17:56 +00:00
2022-07-13 20:32:00 +00:00
## Host an instance yourself
2022-07-28 16:03:17 +00:00
Code might be a little messy, but I do my best to improve it with every commit.
2022-07-08 18:17:56 +00:00
### Requirements
2022-07-08 18:18:52 +00:00
- Node.js 14.16 or above
2022-07-08 18:17:56 +00:00
- git
### npm modules
2022-07-13 20:32:00 +00:00
- cors
2022-07-08 18:17:56 +00:00
- dotenv
2022-07-30 12:01:51 +00:00
- esbuild
2022-07-28 16:03:17 +00:00
- express
2022-07-08 18:17:56 +00:00
- express-rate-limit
- ffmpeg-static
2022-07-28 16:03:17 +00:00
- got
2022-07-08 18:17:56 +00:00
- node-cache
2022-07-28 16:03:17 +00:00
- url-pattern
- xml-js
2022-07-08 18:17:56 +00:00
- ytdl-core
2022-08-01 15:48:37 +00:00
Setup script installs all needed `npm` dependencies, but you have to install `Node.js` and `git` yourself.
2022-07-08 18:17:56 +00:00
1. Clone the repo: `git clone https://github.com/wukko/cobalt`
2. Run setup script and follow instructions: `npm run setup`
2022-07-13 20:32:00 +00:00
3. Run cobalt via `npm start`
2022-07-08 18:17:56 +00:00
4. Done.
2022-08-01 15:48:37 +00:00
## Disclaimer
This is my passion project, so update scheduele depends solely on my motivation. Don't expect any consistency in that.
2022-07-08 18:17:56 +00:00
## License
2022-08-01 15:48:37 +00:00
cobalt is under [AGPL-3.0 ](https://github.com/wukko/cobalt/blob/current/LICENSE ).