Two ways to rotate.

One line does steps 1–3 for you:

curl -fsSL https://dl.rotatr.net/install-docker.sh | bash

1. 01

   Install Docker

   Docker's official script installs Engine, CLI, and the compose plugin together.

   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh

2. 02

   Set up the app directory

   Fetches the current compose file, kept in sync with every release.

   mkdir -p ~/rotatr && cd ~/rotatr
   curl -o docker-compose.yml https://dl.rotatr.net/docker-compose.yml

3. 03

   Pull and start

   Pulls the rotatr image, sets everything up, and starts the program.

   docker compose up -d

4. 04

   Complete the Setup Wizard

   From any computer on your network: http://<your-pi's-ip>:8770
   
   From the Pi's browser: http://localhost:8770

1. 01

   Confirm Art Mode is turned on

   Rotatr can only push images into a Frame TV that already has Art Mode enabled on its own. Check the TV's remote or on-screen settings and turn Art Mode on before running the Setup Wizard again.

2. 02

   Check that the Pi and TV are on the same network

   Mesh Wi-Fi systems often put a guest network on its own subnet, and some routers place wired and wireless clients on separate VLANs. Compare the IP addresses in each device's network settings — the Pi and the TV should be on the same subnet.

3. 03

   Look for client or AP isolation on your router

   Many routers and mesh access points block devices on the same Wi-Fi network from discovering each other directly — a setting usually called client isolation or AP isolation, common on guest networks and some default mesh configurations. Check your router or access point's wireless settings for this option and turn it off for the network the Pi and TV share.

4. 04

   Update the TV's firmware

   Samsung periodically updates the local API that Art Mode pairing relies on. From the TV's own menu, check for a pending software update, install it, and try pairing again.