Set images from livestreams as wallpaper at a given interval (Linux).
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Distributed under the GNU GPL
Or see the file ./LICENSE
Exception: iss_error.png belongs to NASA


Set images from livestreams as wallpaper at a given interval.
By default it uses the HDEV-stream from the International Space Station

With the -s option, you can use any livestream that can be handled
by streamlink.
See man streamlink for more information.

You can find the actual and the previous wallpaper in ~/.streamwall

streamwall is not affiliated or endorsed by NASA.


streamwall is written in bash and depends on:

  • streamlink
  • ffmpeg
  • imagemagick

Optional (default for setting wallpaper):

  • feh


Usage: streamwall [OPTIONS]

Optional arguments:
  -h              Show this help message and exit
  -s <url>        Stream url (defaults to
  -q <quality>    Quality (defaults to 'best'. See 'man streamlink'
                    for more information)
  -o              One-shot
  -b              Ignore blank images
  -n              Ignore error-images from ISS
  -t              Put a timestamp on the wallpaper
  -f <command>    Command to set the wallpaper (defaults to
                    'feh --bg-scale {%FILE}')
  -w              Seconds to wait before getting the next image
                    (defaults to 180)
  -d              Print debug-messages

Using custom streams

With the -s option, you can use a custom livestream that can be handled by

If you want to filter certain images from showing up as wallpaper, you can
fetch those images and put them in a folder ~/.streamwall/filters/.

streamwall will search that folder for those images. The default threshold
for comparing images is 20. If you want to change that, you can add it as
last part of the filename, just before the file-extension (e.g.

High Definition Earth-Viewing System (HDEV)

The High Definition Earth Viewing (HDEV) experiment aboard the ISS was
activated April 30, 2014. It is mounted on the External Payload Facility of
the European Space Agency’s Columbus module. This experiment includes several
commercial HD video cameras aimed at the Earth which are enclosed in a
pressurized and temperature controlled housing. While the experiment is
operational, views will typically sequence though the different cameras.
Between camera switches, a gray and then black color slate will briefly
appear. To learn more about the HDEV experiment, visit here[1].