What are widgets?
A widget is a little app that lives inside a Matrix room: a chess table, a shared whiteboard, a watch party. Anyone in the room can open it, and what you do in it is usually saved in the room, so it's still there next time.
Opening a widget
In a room, press Widgets in the top bar. You'll see the room's widgets as tiles; tap one to open it. The first time, Vommet tells you which website the widget comes from and who added it, and asks before opening it.
Widgets aren't offered in voice rooms (they can get in the way of the call) or in the web version of Vommet.
Adding a widget to a room
- Press Widgets in the room's top bar.
- Choose the first tile, Add widget.
- Pick one from the list, or paste the address of another widget.
Browse what's on offer in the widget catalog; each widget there also has an Add to Vommet button.
You may need to be a moderator
A widget is part of the room's settings, so adding or removing one needs the same permission as changing the room's name or picture. In most rooms that means moderators and admins. If you can't, ask one of them.
What a widget can see and do
A widget is a web page from another website, running inside Vommet. It can't see your messages, your other rooms or your password. It only gets what it asks for and you allow, for example "send and read chess moves in this room". Vommet shows these requests and remembers your answer for that widget.
Only use widgets from people you trust
The widget's makers run its website, and can change what it does at any time. A widget you allow to send messages could send them as you. If a widget asks for more than it needs, don't allow it.
Widgets made by Vommet, like Park Chess, run from vommet.app and their code is open for anyone to read.
Removing a widget
Right-click a widget's tile (or press and hold it on a phone) and choose Remove widget. This removes it for everyone in the room. Clear permissions, in the same menu, only forgets what you allowed it, so it asks again next time.
Widgets in other Matrix apps
Widgets are part of Matrix, so a widget added in Vommet shows up in Element and other apps that support them,
and the other way round. In Element you can add one by typing /addwidget and the widget's address,
which you'll find on its page in the catalog.