Skip to content

underpig1/octos

Repository files navigation

Octos icon

Octos - HTML Live Wallpaper Engine

Create, distribute, and explore live, interactive wallpapers on Windows made with HTML, CSS, and JS.

Download | Documentation | Quickstart | API Docs

Octos GUI

🚧 Pardon the mess: thanks for testing out Octos!

Octos is currently in an early stage of development. To help out, consider submitting a feature request or reporting an issue. And of course, if you have an awesome wallpaper you made that you want to share, consider publishing it on the platform. As always, check out the API docs for resources and guides. Thanks!

Installation

Download the Octos app for Windows (under construction)

Visit releases to download the latest binaries.

Note: your OS may give a Smartscreen warning. I haven't yet gotten around to certifying/signing the app. Right now, I just want to get your impressions and testing on the app, but in the next phase (soon) I'll be working on that as well as hopefully publishing to the Microsoft Store.

Gallery

Here are some sample mods I threw together to demo the app's capabilities. All of them are available through the Octos app. Contribute your own...

Ethereal

Ethereal

An interactive media player that ripples as your mouse passes over it.


Terminal

Terminal

A digital clock with a live old TV effect and customizable 3D text art.


Image Background

Image Background

Set your background to any image/gif/video and add widgets like a media controller, clock, and calender.


Gradient

Gradient

A simple analog desktop clock with a calming color-changing gradient background.

Octos Native API

Making your own live wallpaper is super easy with Octos' native API.

<html>
    <body>
        <p>Now playing: <span id="song-title"></span></p>
        <button onclick="nextTrack()">Next track</button>

        <script src="https://unpkg.com/octos@latest/octos.js"></script>
        <script>
            const controller = new octos.MediaController();

            controller.on("track", (e) => {
                document.getElementById("song-title").innerText = e.title;
            });

            function nextTrack() {
                controller.nextTrack();
            }
        </script>
    </body>
</html>

Use the Octos API to:

  • Get playback info
  • Media/playback controls
  • Read and write to local storage
  • Access file system
  • Read and write user preferences
  • Access system information
  • Learn more with the API Docs

Share your Wallpaper

Once you make your own awesome wallpaper, share it for other people to download from the Octos explore page.

See the publishing guide for more details. Visit the community library to see more mods available for download.