# Words

Words is a self-hosted real-time letter-grid party game for one shared display, where the WebUI creates a temporary room and phone players join using a link or QR code, with no accounts or persistent database required. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3484/words

## Description

Words is a self-hosted real-time letter-grid party game for one shared display, where the WebUI creates a temporary room and phone players join using a link or QR code, with no accounts or persistent database required.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

49/100 (Fair), based on 3 of 4 factors.
- Maintained: 76 (last commit 89 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/words-1y6r6lb1fiu9tf?q=Words
- GitHub: https://github.com/kevinatlee/Words

## Common questions

### Does Words need user accounts or a persistent database?

No, it does not require accounts or a persistent database. Rooms are temporary and the display receives a server-generated room code.

### How do phone players join a room?

Players join with the room-specific /join/:roomCode link or by manually entering a six-character code at /join. The shared display is not counted as a player.

### How is controller authority assigned or changed?

The first player becomes the server-assigned controller, and the connected controller can transfer authority to another connected player. If the controller leaves or misses reconnect grace, the server promotes the earliest-joined connected player, breaking ties by player ID.

### Do disconnects or controller changes pause the round?

No, disconnects, reconnects, and controller transfers do not pause or extend the round. A 250 ms server sweep ends due rounds at the exact deadline.

### What are the default game settings?

New rooms start at 5 × 5 for two minutes. The connected controller can choose a supported grid size and round duration before starting a round.

---
Source: Our Local Host (https://ourlocalhost.com/app/3484/words), the self-hosted and open-source app directory.
