SongPocket is a music player for iOS inspired by record crates.

It’s on the App Store.

Non-goals

SongPocket won’t do everything for everyone, and generally, we should remove and say no to features more often.

So SongPocket tentatively…

1. Won’t offer multiple ways to do the same action. Monotonous design is better.
2. Won’t replace iOS’s Music app, because there’s no API for deleting songs from your library.
3. Won’t show song durations, because they’re spoilers. If this were a music app for everyone, I would add a mode; but it’s not, and modes are bad. (Settings are modes too.)
4. Won’t include appearance options, because they distract. Focus means spending your full attention on what actually matters.

If you want to make different decisions, you can make your own version:

Permissions

You have a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license for this software.

That means you can adapt or share it, but when you do so, please…

1. Mention SongPocket by Loud Sound Dreams.
2. Don’t sell it.
3. Apply these same rules to the resulting work.

Be reasonable. Contact me with any questions.

Compiling

1. Install Xcode on your Mac.
2. Download the code for SongPocket, then open the “LavaRock” Xcode Project file. (That’s SongPocket’s internal name.)
3. Atop the Xcode window, choose an iOS Simulator device, then click “play”.

For help, see Apple’s documentation.

For a physical device

The Simulator doesn’t support most Apple Music features, so you’ll need to develop on a physical device. This takes a few more steps.

1. Plug your iOS device into your Mac.
2. Atop the Xcode window, choose your device, then click “play”. Xcode will show an error, “Unknown Team”.
3. In the menu bar, choose Xcode → Settings → Accounts, then sign in to your Apple account. (Warning: you can only run your app on 3 devices unless you pay for the Apple Developer Program.)
4. In the main Xcode window, in the left sidebar, click the folder icon, then the topmost “LavaRock” row. To the right, below “Targets”, choose “LavaRock”, then above, click “Signing & Capabilities”. Below “Signing (Debug)”, for “Team”, choose your Apple account.
5. Xcode will show an error, “Failed Registering Bundle Identifier”. For “Bundle Identifier”, replace “com.loudsounddreams.LavaRockDebug” with anything else. (This is how Apple devices tell apps apart.) Click “Try Again”, then click “play”.
6. Xcode will say “Developer Mode disabled”. Follow its instructions to turn on Developer Mode on your device. Choose your device, then click “play”.
7. Xcode will say “the request to open ‘[your bundle identifier]’ failed.” Follow its instructions for your iOS device, then click “play”.

For help, see Apple’s documentation.

Contributing

Fork this repo, make your changes in your fork, then open a pull request against my repo. For help, see GitHub’s documentation.

If you change the UI, include screenshots. (You were looking at it anyway, right?)