OASIS_LINUX/docs/FEDIVERSE/MASTODON/connect.md
SITO ddd2787b73 Oasis 0.9.5 con Karvan para escritorio
Rama de desarrollo experimental sobre el Oasis de epsylon, sin afiliacion con el
proyecto original. Base: 0.9.5.

Trae el modulo Karvan —salas efimeras en memoria con autodestruccion por TTL, chat
que funciona sin JavaScript y llamadas de audio y video sobre WebRTC— con el enlace
en el menu lateral por el mismo patron que el resto de modulos: renderKarvanLink
calcado de renderPollsLink, entrada en modules_view y en la lista de /modules.

Los estilos del modulo van en su propia hoja, styles/karvan.css, siguiendo el patron
de highlight.css: asi se ve igual con cualquier tema, sin depender del tema movil.

Sin servidores ICE de terceros: no hay STUN de fabrica, porque un STUN aprende la IP
publica y el momento de cada llamada. Solo candidatos host salvo que se configure un
TURN propio en oasis-config.json, con credenciales efimeras por el mecanismo REST de
coturn.

El codigo propio vive separado —views/fork/, backend/fork_routes.js,
models/karvan_model.js y translations/fork/— de modo que sobre los ficheros de
upstream solo hay enganches de una linea y cada version nueva se integra sin
arrastrar nada.

Respecto al arbol de Android: fuera el wrapper y main.js, que es su arranque; el
tema vuelve a Dark-SNH y se restauran los modulos que en movil se recortan por peso.

Verificado arrancando sin OASIS_MOBILE: nueve rutas OK, menu lateral de upstream con
27 grupos y el enlace de Karvan, cero rastro de la interfaz movil (ni hexagonos, ni
topbar, ni barra inferior), y una sala creada y servida.
2026-08-19 00:35:08 +02:00

69 lines
2.4 KiB
Markdown

# Connect your Mastodon account
The **Fediverse** module lets you use your Mastodon account from inside Oasis: read your timeline, publish posts (text, images or video), reply, boost and favourite — all in one place.
This short guide shows you how to connect your account.
---
## 1) Create an access token in Mastodon
1. Log in to your Mastodon server (for example `mastodon.social`).
2. Go to **Preferences → Development → New application**.
3. Fill in:
- **Application name**: `Oasis`
- **Application website**: optional, leave blank if you want.
- **Redirect URI**: leave the value that's already there.
4. Under **Scopes**, tick these (and nothing else):
```
read:accounts
read:statuses
write:statuses
write:media
write:favourites
```
5. Click **Submit**. Open the new **Oasis** application and copy **"Your access token"**.
> Keep this token private — it lets you post to your account. You can delete it any time from the same Development page.
---
## 2) Connect it in Oasis
1. In Oasis, open **Settings**.
2. Find the **Fediverse** section (the **Mastodon** box).
3. Enter:
- **Address**: your server, e.g. `mastodon.social`.
- **Access token**: the token you just copied.
4. Click **Connect it**.
That's it. Oasis checks the token and opens your timeline. From now on you'll find **Fediverse** in the main menu.
To stop using it, go back to **Settings → Fediverse** and click **Disconnect**.
---
## 3) Using it
Open **Fediverse → Timelines**:
- **Read** your timeline, newest first. Use **Load more** to see older posts.
- **Post**: write in the box, optionally **Attach media** (images or video), **Preview**, then **Publish**.
- **Reply**: open a post's thread and answer from there.
- **Boost** and **Favourite** any post with its buttons.
---
## Show "via Oasis" on your posts (optional)
If you'd like your posts to show that they were sent from Oasis, go to **Preferences → Privacy** in Mastodon and enable **"Display from which app you sent a post"**. Since your application is named `Oasis`, your posts will then show *"via Oasis"*.
---
## If something doesn't work
- **Invalid or expired token** — create the token again and make sure the scopes above are ticked.
- **Invalid instance URL** — use your server's domain, e.g. `mastodon.social`.
- **Couldn't publish / upload** — your token is missing `write:statuses` or `write:media`; re-create it with the right scopes.