Linux Stream Videos and Pictures to an Apple TV with airstream and airimg

• Updated May 15, 2017

If you have ever used an Apple iPhone or Apple TV, you are probably familiar with AirPlay. AirPlay is a way to stream content to an AirPlay compatible device like an Apple TV; it is similar to Google’s Chromecast. However, if you are running a modern Linux distribution, you cannot easily stream anything using the AirPlay protocol. Luckily, an open source tool called airstream has been created to do just that.

Repository Packages Required

This installation step is specific to Fedora, but as long as your particular Linux distribution has a working Ruby environment, the airstream gem should install without a problem.

yum install avahi-compat-libdns_sd-devel rubygem-gem-nice-install

Ruby Gem Required

gem install airstream

Open Firewall Hole

If you are streaming files from your local computer, airstream will start an HTTP server on TCP port 7000 to stream the file to the Apple TV. If you are streaming from a web URL, such as, the file will stream to the Apple TV from there. If you have iptables or firewalld running, be sure to open TCP port 7000.

iptables Port Rule

Be sure to place the following rule above the last iptables rule in the INPUT chain (assuming the last entry in the INPUT chain is a REJECT rule).

iptables -A INPUT -m state --state NEW -p tcp --dport 7000 -j ACCEPT

Be sure to save the new iptables rules so it persists on iptables service restarts.

firewalld Port Rule

firewall-cmd --permanent --zone=public --add-port=7000/tcp && firewall-cmd --reload

airstream Usage

Assuming the file you want to stream to the Apple TV is foo.mp4, use the airstream command like so:

airstream -o /path/to/foo.mp4

airimg Usage

Assuming the file you want displayed on the Apple TV is foo.jpg, use the airimg command like so:

airimg -o /path/to/foo.jpg

You can also display many pictures in a slide show on the Apple TV by using a wild card with the airimg command like so:

airimg -o /path/to/*.jpg

An additional command line switch can be added to display pictures for particular lengths of time.

The expected behavior when displaying many pictures in a slide show is to show one picture after another without interruption, but I have seen situations where displaying many pictures in a slide show will show the picture, go back to the last thing displayed on the Apple TV, display the next picture, and rinse and repeat. I have not been able to figure out why this behavior happens and other times does not.


If you found this post useful and would like to help support this site - and get something for yourself - sign up for any of the services listed below through the provided affiliate links. I will receive a referral payment from any of the services you sign-up for.

Get faster shipping and more with Amazon Prime: About to order something from Amazon but want to get more value out of the money you would normally pay for shipping? Sign-up for a free 30-day trial of Amazon Prime to get free two-day shipping, access to thousands of movies and TV shows, and more.

Thanks for reading and take care.