Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/michioxd/sounddark

An extension/add-on to get better Dark theme for SoundCloud in your favorite browser
https://github.com/michioxd/sounddark

chrome-extension chromium-extension dark-theme edge-extension firefox-addon javascript soundcloud soundcloud-dark-theme sounddark

Last synced: 29 days ago
JSON representation

An extension/add-on to get better Dark theme for SoundCloud in your favorite browser

Host: GitHub
URL: https://github.com/michioxd/sounddark
Owner: michioxd
License: mit
Created: 2023-07-16T08:10:14.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-09-13T13:00:13.000Z (about 2 months ago)
Last Synced: 2024-09-27T11:43:09.335Z (about 1 month ago)
Topics: chrome-extension, chromium-extension, dark-theme, edge-extension, firefox-addon, javascript, soundcloud, soundcloud-dark-theme, sounddark
Language: CSS
Homepage: https://chromewebstore.google.com/detail/sounddark/ablcfojnfkneoplpflnpbeglgkjmiman
Size: 192 KB
Stars: 6
Watchers: 2
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# SoundDark

A better Dark theme for SoundCloud, supported Chromium-based browser and Firefox

![chrome_jndP7OEisJ](https://github.com/michioxd/sounddark/assets/80969068/a0602884-b07e-4d94-b4ea-b88b902d50d9)

## Features

- Toggle theme (original light theme, SoundDark dark theme and auto theme followed the system setting)
- Dark theme :)

## Installation

### Install manually

**Chromium-based browser (Chrome, Microsoft Edge, Brave, Opera,...):**

- Go to [Release page](https://github.com/michioxd/sounddark/releases/latest) then download `chromium-release.zip`
- Extract it in anywhere you want
- Go to Chrome Extension (`chrome://extensions/`), toggle the `Developer Mode` at header
- Click `Load unpacked` then choose the directory of SoundDark you have extracted
- Go to [SoundCloud](https://soundcloud.com) and enjoy :)

[Watch install instruction video on YouTube](https://youtu.be/eIGdk0d-oSQ)

**Firefox-based browser (Firefox, Tor Browser,...):**

- Go to [Release page](https://github.com/michioxd/sounddark/releases/latest) then download `firefox-release.zip`
- Go to Debugging (`about:debugging#/runtime/this-firefox`) then click "Load Temporary Add-on"
- Select `firefox-release.zip` where you downloaded that file.

**Note:** They will unload this extension if you restart your browser!

**WARNING**: Make sure you allow permission for SoundDark on Firefox (not On When Clicked)

![image](https://github.com/michioxd/sounddark/assets/80969068/7806287e-2ca0-417f-918e-54a7ffe725fa)

## Development

- Clone this repository

```shell
git clone https://github.com/michioxd/sounddark
```

- Go to Chrome Extension (`chrome://extensions/`), toggle the `Developer Mode` at header
- Click `Load unpacked` then choose the `src` directory of SoundDark repository you have cloned
- Do everything you want :)

## Building

You can use `npm` if you want, i used `pnpm` instead

```shell
pnpm install
pnpm run pack
```

You should see the `chromium-release.zip` and `firefox-release.zip` in the `dist` directory

## Screenshots

![chrome_H8OF3Yfp5K](https://github.com/michioxd/sounddark/assets/80969068/c3d42c75-4f89-428d-a930-21d43f43b3f4)
![chrome_jndP7OEisJ](https://github.com/michioxd/sounddark/assets/80969068/a0602884-b07e-4d94-b4ea-b88b902d50d9)

wanna see more? [install it lol](#installation)

## Copyright

The SoundCloud logo is a trademark of SoundCloud Global Limited & Co. KG.

## License

All codes are released under [MIT License](LICENSE)

## Credits

Made with love from [michioxd](https://github.com/michioxd) and all [contributors](https://github.com/michioxd/sounddark/graphs/contributors).