Project-icon

NeoMusic - SwiftUI

NeoMusic is an iOS music player app designed to connect many music streaming services into one single app. Taking design queues from neomorphism, buttons and other views have the appearance of popping off the screen.

GitHub Issues Dependencies Swift Version License GitHub Pull Requests

Now playing view Seeking through song Rotating image Toggling now playing view and searching


Installation

  1. This project can be found on the App Store.

  2. Become a beta tester and download the most recent beta on TestFlight.

  3. Instructions to download/fork and clone and get project running

  • Step 1:
$ git clone https://github.com/mazjap/NeoMusic-SwiftUI.git
  • Step 2:
$ open NeoMusic-SwiftUI/NeoMusic-SwiftUI/NeoMusic-SwiftUI.xcodeproj
  • Step 3: Add file called Hidden.swift that contains a static apple_music_api_key variable in the Helpers group:
struct Hidden {
    static let apple_music_api_key = "" // Your Apple Music api key from AppStoreConnect (Leaving as an empty string will still work with local music & searching, but some network features will not)
}
  • Step 4: Ensure Hidden.swift has target membership for both NeoMusic-SwiftUI as well as NeoWidgetExtension

  • Step 5: Connect device or select simulator from drop down and run project

Features

  • Apple Music support
  • Spinnable artwork
  • iOS 14 Widget
  • Changeable color scheme
  • Music searching (local)
  • Toggleable music player view

TODO

  • Apple music searching
  • Profile View/Login
  • Music View
  • Settings
  • Spotify support

Documentation

Please refer to the wiki for technical details on the project.


Contributing

Feature Requests

I would love to hear from you about new features which would improve this app and further the aims of the project. Please provide as much detail and information as possible to show why you think your new feature should be implemented.

Pull Requests

If you have developed a bug fix or new feature that would improve this app, please submit a pull request. It is best to communicate your ideas with me first before investing a great deal of time into a pull request to ensure that it will mesh smoothly with the project.

Remember that this project is licensed under the MIT license, and by submitting a pull request, you agree that your work will be, too.


Contributors

Jordan Christensen

Attribution


License

This project is licensed under the MIT License