<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Compico</title><link>https://compico.github.io/</link><description>Recent content on Compico</description><generator>Hugo</generator><language>en-us</language><lastBuildDate>Fri, 13 Nov 2026 09:00:00 +0300</lastBuildDate><atom:link href="https://compico.github.io/index.xml" rel="self" type="application/rss+xml"/><item><title>Getting started</title><link>https://compico.github.io/overlaycomposer/docs/getting-started/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/getting-started/</guid><description>&lt;p&gt;OverlayComposer shows all your stream widgets through &lt;strong&gt;one Browser Source&lt;/strong&gt; in OBS. You arrange the widgets in a visual editor, and every OBS scene gets its own layout.&lt;/p&gt;&#10;&lt;p&gt;&lt;img src="https://compico.github.io/overlaycomposer/img/index.png" alt="The editor: layers on the left, the canvas in the middle, properties of the selected layer on the right"&gt;&#10;&lt;em&gt;The editor. Dashed outlines are the widgets of the layout, the panel on the right shows the selected layer.&lt;/em&gt;&lt;/p&gt;&#10;&lt;h2 id="1-install-and-run"&gt;1. Install and run&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;Download the latest build for your system from &lt;a href="https://github.com/compico/overlaycomposer/releases"&gt;GitHub Releases&lt;/a&gt;: &lt;code&gt;overlay-composer-windows-amd64.exe&lt;/code&gt; or &lt;code&gt;overlay-composer-linux-amd64&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;Run it. On Windows there is no console window; the app lives in the system tray (the icon opens the editor, the data and log folders, and quits the app).&lt;/li&gt;&#10;&lt;li&gt;The editor opens in your browser at &lt;code&gt;http://127.0.0.1:8000/editor&lt;/code&gt;.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;The app runs entirely on your computer. A second launch does not start a second server, it just opens the editor again.&lt;/p&gt;</description></item><item><title>Connecting to OBS</title><link>https://compico.github.io/overlaycomposer/docs/obs-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/obs-setup/</guid><description>&lt;h2 id="the-browser-source"&gt;The Browser Source&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;Start OverlayComposer.&lt;/li&gt;&#10;&lt;li&gt;In OBS add a &lt;strong&gt;Browser Source&lt;/strong&gt; to a scene.&lt;/li&gt;&#10;&lt;li&gt;Set its URL to &lt;code&gt;http://127.0.0.1:8000/overlay&lt;/code&gt;.&lt;/li&gt;&#10;&lt;li&gt;Set its width and height to your OBS canvas, for example 1920 × 1080.&lt;/li&gt;&#10;&lt;li&gt;Add the same source to every other scene where you want the overlay (&lt;strong&gt;Add Source → Add Existing&lt;/strong&gt;).&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;&lt;img src="https://compico.github.io/overlaycomposer/img/obs.png" alt="OBS with the overlay Browser Source selected"&gt;&#10;&lt;em&gt;One Browser Source named &lt;code&gt;overlay&lt;/code&gt;: all widgets of the current layout are drawn inside it.&lt;/em&gt;&lt;/p&gt;</description></item><item><title>Layouts and editor</title><link>https://compico.github.io/overlaycomposer/docs/layouts/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/layouts/</guid><description>&lt;p&gt;A &lt;strong&gt;layout&lt;/strong&gt; is a set of layers (widgets) on a canvas of a fixed size. Each OBS scene can have its own layout; scenes without one show the &lt;strong&gt;default&lt;/strong&gt; layout.&lt;/p&gt;&#10;&lt;h2 id="layouts"&gt;Layouts&lt;/h2&gt;&#10;&lt;p&gt;The left panel lists layouts. A row shows how many scenes the layout is bound to, and &lt;strong&gt;live&lt;/strong&gt; marks the one that is on air now. &lt;strong&gt;+ New&lt;/strong&gt;, &lt;strong&gt;Duplicate&lt;/strong&gt; and &lt;strong&gt;Delete&lt;/strong&gt; manage them. In the right panel you name the layout, mark it as default, choose the OBS scenes it belongs to (you can also add a scene by name) and set the canvas size.&lt;/p&gt;</description></item><item><title>Settings</title><link>https://compico.github.io/overlaycomposer/docs/settings/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/settings/</guid><description>&lt;p&gt;Open &lt;strong&gt;⚙ Settings&lt;/strong&gt; in the editor header. The window has four tabs; &lt;strong&gt;Save&lt;/strong&gt; applies the changes, and everything is stored in &lt;code&gt;config.json&lt;/code&gt;.&lt;/p&gt;&#10;&lt;p&gt;&lt;img src="https://compico.github.io/overlaycomposer/img/settings.png" alt="Settings window with the vertical tabs"&gt;&lt;/p&gt;&#10;&lt;h2 id="obs"&gt;OBS&lt;/h2&gt;&#10;&lt;p&gt;The connection through obs-websocket, the URL for the Browser Source, and the importer of OBS scenes. See &lt;a href="../obs-setup/"&gt;Connecting to OBS&lt;/a&gt;.&lt;/p&gt;&#10;&lt;h2 id="network"&gt;Network&lt;/h2&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Listen on&lt;/strong&gt; and &lt;strong&gt;Port&lt;/strong&gt;: by default &lt;code&gt;127.0.0.1:8000&lt;/code&gt;, reachable only from this computer. Applied after a restart.&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Log proxy traffic&lt;/strong&gt; prints every proxied request to the server console (and log). Turn it on only while debugging a widget that does not react.&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h3 id="remote-devices-tablet-phone"&gt;Remote devices (tablet, phone)&lt;/h3&gt;&#10;&lt;p&gt;From this computer (&lt;code&gt;127.0.0.1&lt;/code&gt;) the editor and the overlay open without a login. To use another device:&lt;/p&gt;</description></item><item><title>Deck: control panel for a tablet</title><link>https://compico.github.io/overlaycomposer/docs/deck/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/deck/</guid><description>&lt;p&gt;&lt;strong&gt;Deck&lt;/strong&gt; is a page at &lt;code&gt;http://&amp;lt;computer IP&amp;gt;:&amp;lt;port&amp;gt;/deck&lt;/code&gt;: a start screen with large coloured tiles. A tap on a tile switches the OBS scene. It works in old browsers too (an iPad with Safari 9 is supported), so a retired tablet becomes a stream remote.&lt;/p&gt;&#10;&lt;p&gt;&lt;img src="https://compico.github.io/overlaycomposer/img/deck.png" alt="The Deck page: groups of tiles with horizontal scrolling"&gt;&#10;&lt;em&gt;Groups of tiles scroll horizontally. The white frame marks the current scene; the small square in the corner shows the connection state.&lt;/em&gt;&lt;/p&gt;</description></item><item><title>Widgets and plugins</title><link>https://compico.github.io/overlaycomposer/docs/plugins/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/plugins/</guid><description>&lt;p&gt;There are three ways to get a widget onto a layout. All start with &lt;strong&gt;+ Add Source&lt;/strong&gt;.&lt;/p&gt;&#10;&lt;h2 id="1-a-web-page-iframe"&gt;1. A web page (iframe)&lt;/h2&gt;&#10;&lt;p&gt;Enter the URL of any widget (the same address you would give to an OBS Browser Source). If the site refuses to be embedded (alerts of some donation services), tick &lt;strong&gt;Load via server proxy&lt;/strong&gt;: the app opens the page through itself and strips the headers that forbid embedding. HTTP, WebSocket and long-poll work through it.&lt;/p&gt;</description></item><item><title>Writing plugins</title><link>https://compico.github.io/overlaycomposer/docs/plugin-development/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/plugin-development/</guid><description>&lt;p&gt;This page is written to be enough on its own, also for an AI agent that gets only this link (the raw Markdown version ends in &lt;code&gt;index.md&lt;/code&gt;). It covers two kinds of plugins; pick one:&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;HTML widget plugin&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;Standalone plugin (WebAssembly)&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;What it is&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;a folder with &lt;code&gt;plugin.json&lt;/code&gt; and a web page&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;one &lt;code&gt;.wasm&lt;/code&gt; file, runs inside the app&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Language&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;HTML, JS, CSS (any web stack)&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Go (SDK provided); Rust and others through the ABI&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Runs&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;in a sandboxed iframe of the overlay&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;on the server, no window&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Good for&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;what is drawn on the stream: chat, counters, alerts&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;logic that must keep running: Twitch rewards, queues, timers, HTTP calls, bot messages, events&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;Can have a UI&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;it is the UI&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;yes: widgets and a settings page packed into the same file&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;p&gt;They combine: a standalone plugin can ship its own widgets, and a widget talks to its plugin through &lt;code&gt;oc.plugin&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>Troubleshooting</title><link>https://compico.github.io/overlaycomposer/docs/troubleshooting/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://compico.github.io/overlaycomposer/docs/troubleshooting/</guid><description>&lt;h2 id="the-overlay-is-not-visible-in-obs"&gt;The overlay is not visible in OBS&lt;/h2&gt;&#10;&lt;ol&gt;&#10;&lt;li&gt;Open &lt;code&gt;http://127.0.0.1:8000/overlay?debug=1&lt;/code&gt; in a browser, or append &lt;code&gt;?debug=1&lt;/code&gt; to the Browser Source URL. A corner label shows the WebSocket state, the layout, the number of objects and the last error.&lt;/li&gt;&#10;&lt;li&gt;Open &lt;strong&gt;⚙ Settings → Application → Open log folder&lt;/strong&gt; and read the latest lines. &lt;code&gt;client …&lt;/code&gt; is what the overlay reported, &lt;code&gt;http …&lt;/code&gt; is what OBS requested, &lt;code&gt;proxy: …&lt;/code&gt; is what a proxied site answered. If &lt;code&gt;/overlay&lt;/code&gt; never appears in the log, OBS did not reach the server: check the URL and port.&lt;/li&gt;&#10;&lt;li&gt;Frequent page reloads can make a widget&amp;rsquo;s site answer &lt;code&gt;Too Many Requests&lt;/code&gt;: wait a bit.&lt;/li&gt;&#10;&lt;/ol&gt;&#10;&lt;p&gt;To debug a Browser Source in DevTools start OBS with &lt;code&gt;--remote-debugging-port=9222 --remote-allow-origins=http://localhost:9222&lt;/code&gt;, then open &lt;code&gt;http://localhost:9222/&lt;/code&gt; in Chrome.&lt;/p&gt;</description></item><item><title>OverlayComposer: one Browser Source, a layout for every scene</title><link>https://compico.github.io/overlaycomposer/releases/first-release/</link><pubDate>Fri, 13 Nov 2026 09:00:00 +0300</pubDate><guid>https://compico.github.io/overlaycomposer/releases/first-release/</guid><description>The first full release: the editor, scene layouts, proxy mode, widgets and plugins, standalone WebAssembly plugins, and Deck for a tablet.</description></item></channel></rss>