Put ESKEES works on your site

Alpha (September 2026). Details may change without notice.

Demo

This is “Kasanete 2048” placed on this page with <eskees-player>. Click to start (arrow keys or swipe).

1. Embed a showcase work

Press Embed on a work’s showcase page to get the code. For a work at https://showcase.eskees.com/w/ID:

<iframe src="https://showcase.eskees.com/embed/ID"
  style="width: 100%; aspect-ratio: 16 / 9; border: 0"
  allow="autoplay; fullscreen; gamepad" loading="lazy"></iframe>

• Nothing is downloaded until the player is clicked.
• Scores can be added to the ranking right there (only when the player presses the button).
• Works that are no longer public show “This work is not available.”

2. Host your own .eskx (ESKEES Player)

Export a .eskx from ESKEES (“Export ▾”), put it on your server, and write:

<script type="module" src="https://showcase.eskees.com/player/1/eskees-player.js"></script>

<eskees-player src="/games/my-game.eskx" style="width: 800px; aspect-ratio: 16 / 9"></eskees-player>

Attributes

Your page decides the size. Without one, it fills the width at 16:9. Match the work’s canvas ratio with aspect-ratio to avoid margins.

Events

document.querySelector('eskees-player').addEventListener('eskees-score', (e) => {
  console.log(e.detail.board, e.detail.value);
});

From JavaScript

<script type="module">
  import { mount } from 'https://showcase.eskees.com/player/1/eskees-player.js';
  const game = await mount(document.getElementById('game'), '/games/my-game.eskx', { autoplay: true });
  // game.restart(), game.togglePause(), game.destroy()
  // Connect to Twitch chat with { twitch: 'channel' }; send your own events with game.live({ kind: 'chat', source: 'test', user: 'Taro', text: 'lol', amount: 0 })
</script>

Pass values into the work

Your page or app can pass values it holds (voice level, app state…) into the work. Both the <eskees-player> element and the object returned by mount have these methods.

const orb = await mount(el, '/orb.eskx', { autoplay: true, transparent: true, fps: 30, scale: 0.75 });
orb.set('state', 2);      // the work reacts with on change state
orb.set('level', 0.8);    // declare var level = 0 to 1 in the script

Bundle the Player with your app or site

For offline use (for example, inside a mobile app), you can host the Player files yourself.

• Files: eskees-player.js and the chunks/ folder next to it, as-is. The same files are in engine/play/ where the ESKEES CLI is installed. Files in chunks/ load only for works that use physics (planck.js) or text effects (JIZURA)
• Passing the work: mount(el, ArrayBuffer, …) takes the bytes of the .eskx directly (no fetch)
• It does not run from file:// (browsers block ES modules and import() there). Serve it over https:// or your app's built-in server (such as Capacitor's https://localhost)
• WebGL2 is required (there is no fallback renderer)
• It only goes online for works that use Google Fonts, for JIZURA fonts, and when twitch / relay is set. No score submission or analytics
• Drawing and scripts stop while the page is hidden. live() calls made while paused or before the work opens are dropped; when you come back to the foreground, send the state again with set (values passed with set are never dropped)
• The ESKEES Player does not keep resume data. saves only decides where the script's save data goes
• When you distribute it bundled, include LICENSE.md and NOTICE.md (found where the ESKEES CLI is installed)

3. Export a web page from Studio

In ESKEES Studio, Export ▾ → Export as a web page (HTML) produces one HTML file with the work inside.

• Upload that HTML and it plays. No separate .eskx and no CORS setup.
• It runs on ESKEES Player (CDN); visitors’ browsers load the player from showcase.eskees.com.
• The work is embedded, so the file is about 4/3 the size of the work. For large works, method 2 (host the .eskx and use <eskees-player src>) is lighter.

Where it works

• Works: anywhere you can write your own HTML and JavaScript (your server, shared hosting, GitHub Pages, Netlify, Vercel, Cloudflare Pages…). On self-hosted WordPress, use a Custom HTML block.
• Does not work: services that strip <script> from posts (most blog and article platforms). If they allow iframes, use embed method 1.
• Sites with a Content-Security-Policy need https://showcase.eskees.com in script-src.

Notes

• If the .eskx is on another domain, that server must allow CORS (ESKEES Player fetches it). No setup is needed on the same site.
• You can place several players on one page. Only the last one clicked receives key presses.
• Works that use physics also load the physics library (planck.js), only when needed.
• Under /player/1/, attributes, events and mount() stay the same. Fixes ship without notice; breaking changes get /player/2/.
• If you only need the EMG part (images and animation), the public EMG CDN player also works. It does not run .eskx extensions such as scripts.