octos
v1.0.2
Published
HTML live wallpaper engine
Downloads
69
Readme
Octos - HTML Live Wallpaper Engine
Create, distribute, and explore live, interactive wallpapers on Windows made with HTML, CSS, and JS.
Documentation | Quickstart | API Docs
:construction: 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.
If you have npm, you can use it instead to just test out the app without installing.
Clone the repository and run npm install to install any dependencies and npm start.
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
An interactive media player that ripples as your mouse passes over it.
Terminal
A digital clock with a live old TV effect and customizable 3D text art.
Image Background
Set your background to any image/gif/video and add widgets like a media controller, clock, and calender.
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.