cobalt-7/README.md

# cobalt
Sleek and easy to use social media downloader built with JavaScript.

Try it now: [co.wukko.me](https://co.wukko.me/)

![cobalt logo](https://raw.githubusercontent.com/wukko/cobalt/current/src/front/icons/wide.png "cobalt logo")

## What's cobalt?
cobalt aims to be the ultimate social media downloader, that is efficient, pretty, and doesn't bother you with ads or privacy invasion agreement popups. It also doesn't remux anything, so you get media in best quality possible (unless you change that in settings). 

## Supported services

### Video
- bilibili.com
- douyin
- Reddit
- TikTok
- Tumblr
- Twitter
- YouTube
- YouTube Music
- VK

### 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)

## 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.

## TO-DO

### Services
- [x] Tumblr support
- [ ] niconico support
- [ ] Instagram support
- [ ] SoundCloud support
- [ ] Add an option to save Twitter GIFs as `.gif` instead of `.mp4`
- [ ] Quality switching for bilibili

### Other
- [ ] Language picker in settings
- [ ] Make switch buttons in settings selectable with keyboard
- [ ] Option to save audios in formats other than original
- [ ] Make cobalt fully PWA compatible (add a service worker)
- [ ] Make page rendering module more versatile

## 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.

## License
cobalt is under [AGPL-3.0](https://github.com/wukko/cobalt/blob/current/LICENSE).
moved to new repo 2022-07-08 18:17:56 +00:00			`# cobalt`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`Sleek and easy to use social media downloader built with JavaScript.`

			`Try it now: [co.wukko.me](https://co.wukko.me/)`
moved to new repo 2022-07-08 18:17:56 +00:00
fixed readme logo 2022-07-30 09:12:32 +00:00			`![cobalt logo](https://raw.githubusercontent.com/wukko/cobalt/current/src/front/icons/wide.png "cobalt logo")`
moved to new repo 2022-07-08 18:17:56 +00:00
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`## What's cobalt?`
			`cobalt aims to be the ultimate social media downloader, that is efficient, pretty, and doesn't bother you with ads or privacy invasion agreement popups. It also doesn't remux anything, so you get media in best quality possible (unless you change that in settings).`
moved to new repo 2022-07-08 18:17:56 +00:00
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`## Supported services`
moved to new repo 2022-07-08 18:17:56 +00:00
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`### Video`
moved to new repo 2022-07-08 18:17:56 +00:00			`- bilibili.com`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`- douyin`
moved to new repo 2022-07-08 18:17:56 +00:00			`- Reddit`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`- TikTok`
added support for tumblr - support for tumblr is back! (i tried all types of links in clear sight and everything seems to work, lmk if something doesn't) - increased stream lifespan up to 1 hour - made youtube audios download without additional conversion, speed should be a bit better but not by much cause youtube limits the audio download speed :( 2022-08-01 17:53:44 +00:00			`- Tumblr`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`- Twitter`
			`- YouTube`
			`- YouTube Music`
moved to new repo 2022-07-08 18:17:56 +00:00			`- VK`

basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 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)`

			`## 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.`

tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 2022-07-28 16:03:17 +00:00			`## TO-DO`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00
			`### Services`
added support for tumblr - support for tumblr is back! (i tried all types of links in clear sight and everything seems to work, lmk if something doesn't) - increased stream lifespan up to 1 hour - made youtube audios download without additional conversion, speed should be a bit better but not by much cause youtube limits the audio download speed :( 2022-08-01 17:53:44 +00:00			`- [x] Tumblr support`
faster and more accessible - spanish localization by @adrigoomy - cobalt should load even faster cause all loaded files are now way smaller (esbuild implementation) 2022-07-30 09:11:25 +00:00			`- [ ] niconico support`
tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 2022-07-28 16:03:17 +00:00			`- [ ] Instagram support`
added support for tumblr - support for tumblr is back! (i tried all types of links in clear sight and everything seems to work, lmk if something doesn't) - increased stream lifespan up to 1 hour - made youtube audios download without additional conversion, speed should be a bit better but not by much cause youtube limits the audio download speed :( 2022-08-01 17:53:44 +00:00			`- [ ] SoundCloud support`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			- [ ] Add an option to save Twitter GIFs as `.gif` instead of `.mp4`
			`- [ ] Quality switching for bilibili`

			`### Other`
it's all about you and your native language! - finally cleaned up localisation (now i18n) - made localisation strings easier to read and understand - removed static selected language in service modules - added support for russian language (привет-привет) - it's now extremely easy to add support for more languages. just copy en folder in i18n and start translating strings. pull requests for adding languages are more than welcome. 2022-07-17 12:58:51 +00:00			`- [ ] Language picker in settings`
moved to new repo 2022-07-08 18:17:56 +00:00			`- [ ] Make switch buttons in settings selectable with keyboard`
added support for tumblr - support for tumblr is back! (i tried all types of links in clear sight and everything seems to work, lmk if something doesn't) - increased stream lifespan up to 1 hour - made youtube audios download without additional conversion, speed should be a bit better but not by much cause youtube limits the audio download speed :( 2022-08-01 17:53:44 +00:00			`- [ ] Option to save audios in formats other than original`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`- [ ] Make cobalt fully PWA compatible (add a service worker)`
			`- [ ] Make page rendering module more versatile`
moved to new repo 2022-07-08 18:17:56 +00:00
beginning of 2.2 - added download popup to solve the issue with downloads on ios - merged big and small popups into one - made buttons in donation menu act like buttons - began to clean up localisation - added ability to embed repo url into localisation strings - moved ffmpeg args to config for more flexibility (and hopefully future changes) - removed error response in stream that could result in a crash - removed notice for ios users from about cause it's no longer relevant - made error popup look and act like the rest - a tiny bit of clean up - ill do better changelog tomorrow i think 2022-07-13 20:32:00 +00:00			`## Host an instance yourself`
tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 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.`
moved to new repo 2022-07-08 18:17:56 +00:00
			`### Requirements`
Update README.md 2022-07-08 18:18:52 +00:00			`- Node.js 14.16 or above`
moved to new repo 2022-07-08 18:17:56 +00:00			`- git`

			`### npm modules`
beginning of 2.2 - added download popup to solve the issue with downloads on ios - merged big and small popups into one - made buttons in donation menu act like buttons - began to clean up localisation - added ability to embed repo url into localisation strings - moved ffmpeg args to config for more flexibility (and hopefully future changes) - removed error response in stream that could result in a crash - removed notice for ios users from about cause it's no longer relevant - made error popup look and act like the rest - a tiny bit of clean up - ill do better changelog tomorrow i think 2022-07-13 20:32:00 +00:00			`- cors`
moved to new repo 2022-07-08 18:17:56 +00:00			`- dotenv`
added esbuild to list of npm modules 2022-07-30 12:01:51 +00:00			`- esbuild`
tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 2022-07-28 16:03:17 +00:00			`- express`
moved to new repo 2022-07-08 18:17:56 +00:00			`- express-rate-limit`
			`- ffmpeg-static`
tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 2022-07-28 16:03:17 +00:00			`- got`
moved to new repo 2022-07-08 18:17:56 +00:00			`- node-cache`
tiktok is back! - added support for tiktok (images won't work, they're only accessible through the app) - hopefully main input bar is now not rounded on ios, i fucking hate apple - if service is not supported, a correlating error will appear, not generic one - removed duplicates from config that are present in package json already - tiny bit of clean up 2022-07-28 16:03:17 +00:00			`- url-pattern`
			`- xml-js`
moved to new repo 2022-07-08 18:17:56 +00:00			`- ytdl-core`

basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 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.
moved to new repo 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`
beginning of 2.2 - added download popup to solve the issue with downloads on ios - merged big and small popups into one - made buttons in donation menu act like buttons - began to clean up localisation - added ability to embed repo url into localisation strings - moved ffmpeg args to config for more flexibility (and hopefully future changes) - removed error response in stream that could result in a crash - removed notice for ios users from about cause it's no longer relevant - made error popup look and act like the rest - a tiny bit of clean up - ill do better changelog tomorrow i think 2022-07-13 20:32:00 +00:00			3. Run cobalt via `npm start`
moved to new repo 2022-07-08 18:17:56 +00:00			`4. Done.`

basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 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.`

moved to new repo 2022-07-08 18:17:56 +00:00			`## License`
basically new readme and more languages - indonesian localization by @LyfeV - rewrote readme - added new line at the end for files that were missing it 2022-08-01 15:48:37 +00:00			`cobalt is under [AGPL-3.0](https://github.com/wukko/cobalt/blob/current/LICENSE).`