Simple and Fast Multimedia Library
SFML for Node.js
The Node.js binding for SFML. Create native windows, draw 2D graphics and play audio in JavaScript or TypeScript.
npm install sfml.jsmacOS / Windows / Linux
Built on SFML 3.1 · About SFMLThe SFML modules
Open a window, draw sprites, play music and exchange data. SFML provides the building blocks for your desktop application.
Module guidesRenderWindow · CircleShape · Color
Your first SFML window.
Create a RenderWindow, draw a CircleShape, then display the frame. SFML handles the window and rendering; your JavaScript drives the loop. TypeScript declarations are included.
Follow the quick startRun this in a graphical desktop session. Escape closes the window; setImmediate leaves room for Node.js I/O between frames.
node hello.cjsconst sf = require('sfml.js');
const win = new sf.RenderWindow(
new sf.VideoMode(new sf.Vector2u(800, 600)),
'Hello, sfml.js',
);
const circle = new sf.CircleShape({ radius: 80 });
circle.setPosition(new sf.Vector2f(320, 220));
circle.setFillColor(new sf.Color(108, 190, 82));
win.setFramerateLimit(60);
function frame() {
win.handleEvents({
Closed: () => win.close(),
KeyPressed: e => {
if (e.code === sf.Keyboard.Key.Escape) win.close();
},
});
if (!win.isOpen()) return;
win.clear(new sf.Color(24, 28, 32));
win.draw(circle);
win.display();
setImmediate(frame);
}
frame();SFML examples
Run the examples for graphics, text, shaders, audio recording and networking.
play-nes · Desktop NES emulator with sfml.jsView source
node-sfml-demos · Game implementations using sfml.jsView source
Breakout
Breakout, drawn with SFML shapes. Keyboard input and the game loop run in Node.js.
Draw into a texture.
Use SFML’s RenderTexture as an off-screen target, then display its contents with a Sprite. This running example shows texture composition and captured draw states.
SFML concepts. JavaScript APIs.
Read the SFML C++ documentation alongside the binding’s type reference. Our guides cover promises, shared typed arrays, resource lifetime and batched rendering in Node.js.