Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pelauimagineering/apple-music-token-generator
https://github.com/pelauimagineering/apple-music-token-generator
apple-music jwt-token python ruby
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pelauimagineering/apple-music-token-generator
- Owner: pelauimagineering
- License: mit
- Created: 2017-06-08T06:50:56.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-01-17T21:10:59.000Z (almost 2 years ago)
- Last Synced: 2024-08-09T02:14:52.493Z (5 months ago)
- Topics: apple-music, jwt-token, python, ruby
- Language: JavaScript
- Size: 23.4 KB
- Stars: 277
- Watchers: 8
- Forks: 52
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - pelauimagineering/apple-music-token-generator - (JavaScript)
README
# apple-music-token-generator
Some steps that help getting started creating the Apple Music JWT tokens needed to use MusicKit on iOS
## Recent Change
Added a NodeJS version.
## Getting Started
These instructions supplement the information found in the Get Started section of the Apple Music API Reference documents.
First, you must follow the instructions at [Apple Music API Reference](https://developer.apple.com/library/content/documentation/NetworkingInternetWeb/Conceptual/AppleMusicWebServicesReference/SetUpWebServices.html#//apple_ref/doc/uid/TP40017625-CH2-SW1)
Next, follow the instructions below to help create your developer token in the JSON Web Token format.
## Prerequisites
A developer machine running macOS Sierra (10.12.5)
You will need to run Terminal and have root access, or can run sudo
After following the instructions at the URL above, you should now have 3 pieces of data:
- a MusicKit private key in a *.p8 file
- a 10-digit key identifier in your Apple Developer account
- your 10-digit Apple Developer Account Team ID
## Installing (Python)
### Step 1
### Easy method:
Run the following on the command line:
```
sudo easy_install pip
```
### Old method:
Download the Python package manager from [pip](https://pip.pypa.io/en/stable/installing/)
```
Download the get-pip.py script from https://pip.pypa.io/en/stable/installing/
```
Install Python package manager
```
sudo python get-pip.py
```
### Step 2
Now that the Python Package Manager (pip) is installed, use it to install the Python JWT library
```
sudo pip install pyjwt
```
Add the necessary Cryptography package
```
sudo pip install cryptography
```
All of that was just housekeeping to get you ready for the main event... actually generating the token.
Use you favourite editor to customize the script that will create your token.
```
open -e music_token.py
```
Copy your MusicKit private key from the .p8 file you generated and downloaded.
```
secret = """-----BEGIN PRIVATE KEY-----
REPLACE-THIS-WITH-YOUR-OWN-PRIVATE-KEY
-----END PRIVATE KEY-----"""
```
Substitute your 10-digit key identifier (kid) as found in your developer account
```
keyId = "9876543210"
```
Substitute your 10-digit Apple Developer Team ID
```
teamId = "0123456789"
```
Run the script
```
> python music_token.py
```
The script will output a sample curl command you can run to see if you were successful.
```
```
## Installing and Running in Node
### System requirements
Ensure you have a current version of Node and npm running on your system.
### Installation
Download the repo and run ```npm install``` in the project directory to install dependancies.
### Configuration
The project supports ```.env``` and you can add the following to your own ```.env``` file in the project directory.
```
TEAM_ID=[YOUR_TEAM_ID_FROM_APPLE]
KEY_ID=[YOUR_KEY_ID_FROM_APPLE]
```
### Running
There are two ways of using the Node create_token.js package:
In the project directory, run ```npm run generate``` and pass in the filename to your .p8 private key file.
** *OR* **
Simply run ```npm run generate``` follow the on screen prompts.
- provide the file path/name
- provide your Team ID
- provide your Key ID
### Testing
The script has built in tests and will display test results during runtime.
If you wish to skip the validation step (i.e. 'offline mode'), configure the ```VALIDATE_TOKEN``` flag in create_token.js
## Contributing
Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
## Authors
* **Anonymous Apple Marketing Guy** - *Initial work* - [Anonymous]
* **Darren Baptiste** - *First Commit* - [Pelau Imagineering](https://github.com/pelauimagineering)
* **Nate Blake** - *NodeJS version* - [n8blake](https://n8blake.com)
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## Acknowledgments
* Hat tip to the folks in the MusicKit Lab at WWDC17