## This project is NO LONGER MAINTAINED, do not use it!

8 years, 11 months, 11 days after the [first
commit](https://github.com/salomvary/soundcleod/commit/63c11038cace325d07d25191b01e744ba09a5b19)
I realized I've lost interest, motivation and time for maintaining SoundCleod
and decided to retire the project. The GitHub repository is read-only from now,
the soundcleod.com domain will continue working until it expires on 2022-05-05.

It is strongly recommended to uninstall SoundCleod to prevent future security
issues, for which no fixes will be released.

For those seeking alternatives I recommend switching to the official
[SoundCloud Desktop Player](https://help.soundcloud.com/hc/en-us/articles/1260803560930-Desktop-Player)
or using any modern web browser.

## What is SoundCleod?

SoundCleod is a desktop application which brings
[SoundCloud](http://soundcloud.com) to macOS and Windows without using a web
browser.

Compared to using SoundCloud.com in a web browser like Chrome or Firefox you
will get the following extras when using SoundCleod:

- Dark mode
- Desktop notifications
- Control playback using media keys on the keyboard (▶ ❚❚ and friends)
- True full screen without browser buttons
- Control playback from the Notification Center using the Now Playing widget on macOS
- Control playback from the macOS application menu
- Stop playback when your computer goes to sleep
- Close or hide all windows without interrupting playback

SoundCleod is a weird name. [How to pronounce it?](https://soundcloud.com/senart/soundcleod)

## How to get it?

Current version is 2.0.0 (May 19, 2020) [see changes](https://github.com/salomvary/soundcleod/blob/master/CHANGELOG.md)

### For macOS

- [Download macOS installer from
  here](https://updates.soundcleod.com/download/mac)
- Locate the installer (.dmg) file in Finder
- Double click on the installer file
- Drag SoundCleod into your Applications folder
- Double click SoundCleod in the Applications folder
- Optionally drag SoundCleod from Applications into the Dock

**Important!** Minimum required macOS version is 10.10 (Yosemite).

### For Windows

- [Download Windows installer from
  here](https://updates.soundcleod.com/download/windows)
- Save the file when prompted
- Run the downloaded installer

**Important!** Windows 7 or newer is required (only 64 bit, 32 bit Windows is not supported).

### Using [Homebrew Cask](https://formulae.brew.sh/cask/)?

```sh
brew install soundcleod
```

Note: the homebrew method is supported by the [Caskroom team](https://github.com/caskroom/homebrew-cask),
please [report installation issues](https://github.com/caskroom/homebrew-cask#reporting-bugs) there.

## Screenshots? Yeah!

![SoundCleod screenshot](https://raw.github.com/salomvary/soundcleod/master/screenshot.jpg)

![SoundCleod dark mode screenshot](https://raw.github.com/salomvary/soundcleod/master/screenshot-dark.jpg)

## Alternatives

To play SoundCloud:

- Any modern web browser
- [SoundCloud Desktop Player](https://help.soundcloud.com/hc/en-us/articles/1260803560930-Desktop-Player)
  (official Chromium app)
- [BeardedSpice](https://github.com/beardedspice/beardedspice) (Mac)
- [Soundnode App](http://www.soundnodeapp.com/) (Mac, Win, Linux)
- [Cumulus](https://github.com/gillesdemey/Cumulus) (Mac)
- [Vox](http://coppertino.com/) (Mac)
- [DaftCloud](https://daft.cloud/) (Mac)

## Forks Using SoundCleod "Engine"

To play other stuff:

- [TwentyTwo](https://github.com/marcw/twentytwo)
- [BeotsMusic](http://beotsmusic.kiding.net/)

## Contributing, reporting bugs

SoundCleod is an open source project built by [Márton
Salomváry](https://twitter.com/salomvary) released under [MIT
license](https://github.com/salomvary/soundcleod/blob/master/LICENSE). The
project is [hosted on GitHub](https://github.com/salomvary/soundcleod), feel
free to fork the code and make any changes you want. We even have [documentation
for first-time contributors](https://github.com/salomvary/soundcleod/blob/master/CONTRIBUTING.md)!

Found a bug? Have a feature request? [Create a GitHub
issue](https://github.com/salomvary/soundcleod/issues).

## Disclaimer

Use at your own risk. It might destroy the Earth. Or better don't use
it.