{"id":26940629,"url":"https://github.com/illberoy/spotify-tvos-app","last_synced_at":"2026-04-05T21:05:36.354Z","repository":{"id":73813418,"uuid":"172268845","full_name":"illBeRoy/spotify-tvos-app","owner":"illBeRoy","description":"📺 TVOS Spotify App using Spotify Connect API","archived":false,"fork":false,"pushed_at":"2019-02-26T23:59:33.000Z","size":3757,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-08T06:34:38.038Z","etag":null,"topics":["app","music","react","react-native","spotify","tvos"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/illBeRoy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-23T22:01:04.000Z","updated_at":"2023-12-27T20:48:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"e635db64-48d1-4968-a28f-bd02163519fc","html_url":"https://github.com/illBeRoy/spotify-tvos-app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illBeRoy%2Fspotify-tvos-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illBeRoy%2Fspotify-tvos-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illBeRoy%2Fspotify-tvos-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illBeRoy%2Fspotify-tvos-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/illBeRoy","download_url":"https://codeload.github.com/illBeRoy/spotify-tvos-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246847054,"owners_count":20843438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app","music","react","react-native","spotify","tvos"],"created_at":"2025-04-02T15:42:32.373Z","updated_at":"2025-12-30T22:47:25.218Z","avatar_url":"https://github.com/illBeRoy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![logo](logo.png)\n# 📺 Spotify App for tvOS\n\u003e A Spotify Connect App for personal use on Apple TV made with React Native\n\n## What's That?\nA Spotify application built with React Native which uses the Spotify Connect API. It allows you to view and control your Spotify session from your Apple TV:\n\n![screenshot](screenshot.png)\n[📽 See it in action](https://streamable.com/mxsg6)\n\nIt started as a personal project to test out React Native for tvOS. I really wanted a Spotify app for my Apple TV, and this is the result. I used Sketch to design it, and it is written in Typescript and tested with Jest and react-native-testing-library.\n\nThis project is free to use and modify, but bear in mind that Spotify is a commercial product and so this project is only meant for personal use.\n\nThe application is entirely custom made **and is in no way affiliated with Spotify**.\n\n## Getting Started\n### Prerequesits\n* Knowledge of React Native\n* Mac + XCode\n* Create a Spotify app in the [Spotify Dashboard](https://developer.spotify.com/dashboard)\n\n### Initializing the project\nClone this project to your machine by running:\n```bash\ngit clone git@github.com:illBeRoy/spotify-tvos-app.git\n```\n\nNow install the required dependencies by running:\n```bash\nnpm install\n```\n\n### Passing Tests\nThe next step is to make sure that everything works fine by passing the tests.\nStart with creating a spotify configuration file (it does not exists in this repo as it contains personal configuration):\n\n*src/api/spotify.config.ts*\n```typescript\nexport default {\n  CLIENT_AUTH: 'FOO',\n  REFRESH_TOKEN: 'BAR'\n};\n```\n\nWe'll learn more about the config file in a minute, for now it can contain random values.\n\nNext, run the following command:\n```bash\nnpm test\n```\n\nIf everything passes, we're good to go!\n\n### Configuring The Project\nThe `spotify.config.ts` file contains two values:\n* `CLIENT_AUTH`: your [Spotify app](https://developer.spotify.com/dashboard) client id and secret, formatted as: `\u003cclient_id\u003e:\u003cclient_secret\u003e` encoded in base64\n* `REFRESH_TOKEN`: a refresh token for your own personal spotify **account** (not app), which can be used to produce access tokens.\n\nThe Spotify API client in the app uses the above to produce access tokens for your account, and that's how it can read and control your Spotify sessions. Read more about the authorization code flow [here](https://developer.spotify.com/documentation/general/guides/authorization-guide/#authorization-code-flow).\n\nIf you're not sure how to get your `REFRESH_TOKEN`, refer to Spotify's own [web-api-auth-examples](https://github.com/spotify/web-api-auth-examples). Do not forget to include the `user-read-playback-state` and `user-modify-playback-state` scopes when you generate your `REFRESH_TOKEN`.\n\n### Running The Project\nFinally! Now that everything is ready, simply run the following command:\n```bash\nnpm start\n```\n\nIf everything works correctly, this will start your React Native bundler and app inside a tvOS simulator.\n\n### Deploying to Apple TV\nIf everything works fine and you're satisfied, you can install a working copy of the app on your Apple TV.\n\nStart by opening XCode. Switch the build scheme to `spotify-tvOS-release`. The next thing to do is to connect your Mac to your Apple TV (via USB-C). You should be able to find your Apple TV device near the Build button in XCode.\n\nFinally, press build and pray for the best. If everything works as expected, you'll see your new Spotify app on your Apple TV.\n\n🎉 Congratulations!\n\n## Disclaimer\nAs previously mentioned, this is a personal project and is in no way affiliate with Spotify.\n\nCloning, building, running and creating personal refresh tokens are under your exclusive responsibility.\n\nSome of the icons used in the design are taken from [flaticon](https://flaticon.com).\n\nFeel free to page me for anything! Enjoy!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillberoy%2Fspotify-tvos-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fillberoy%2Fspotify-tvos-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillberoy%2Fspotify-tvos-app/lists"}