jamesj503 / roku-unsplash-screensaver

Roku Unsplash Screensaver

Ad-Free Open Source Roku Screensaver showing random images from Unsplash.

How to install

1. To enter dev mode, using your Roku remote, enter the following button sequence:

   🏠 🏠 🏠 + 🔼 🔼 + ▶️ ◀️ + ▶️ ◀️ + ▶️

2. Follow instructions on Roku developer program. Make sure you succeed with their hello world example first.

3. Clone this repository and cd into it.

4. Download app.mk from roku's example to project's parent folder

   wget https://raw.githubusercontent.com/rokudev/samples/master/getting%20started/makefile/app.mk -O ../app.mk

5. Copy and fill environment variables

   cp .env .env.example
   vim .env # or use whatever editor you want here

6. Load environment variables

   export $(cat .env | xargs)

   Note: The above command is the equivalent of running export WHATHEVER=something in your shell for each line in the .env, you could also export them by hand if you prefer, but using the above command will prevent you from writing secrets in your shell history 🙈.

7. Deploy to your device

   make install

   if you're on MacOS and you get 'ERROR: Device is not responding to ping.', refer to rokudev/samples#28.

🎉

Contributing

Contributions are welcome! 🙏

1. Make sure you read Roku Screensavers documentation if you intend to modify the code.
2. Have a look to the issues, there's some work and open questions in here.

Disclaimer

This repository is not sponsored by or affiliated with Roku and Unsplash.

License

MIT © Gabriel Le Breton