Benutzer und Rollen

Einrichtung

Gib jeder Person in deinem Haushalt ein eigenes Konto mit genau den Rechten, die sie braucht. Der Besitzer und die Admins arbeiten unter Settings > Users and roles (Einstellungen > Benutzer und Rollen).

Jemanden einladen

Öffne Settings > Users and roles.
Wähle Member (Mitglied). Der Besitzer kann auch Admin wählen.
Prüfe die Berechtigungen. Bei den Standardberechtigungen der Rolle ist der Haken schon gesetzt.
Füge eine private Notiz hinzu, wenn du dir merken willst, für wen der Link ist.
Wähle, wie lange der Link gilt: 1 bis 30 Tage, Standard 7.
Klicke auf Make an invite link (Einladungslink erstellen) und kopiere ihn gleich. Du solltest den vollständigen Link einmal sehen; er funktioniert einmal.

Die Person öffnet den Link und wählt einen eindeutigen Namen und ein Passwort, das die aktuelle Mindestlänge erfüllt. Danach ist sie angemeldet.

Für ein Kind mit Altersgrenze siehe Kinderkonten.

Rollen und Berechtigungen

Rolle	Was sie bedeutet
Besitzer	Das erste Konto. Darf alles. Auf diesem Bildschirm kann niemand es ändern oder ausschalten
Admin	Verwaltet Mitglieder und die Bibliothek, im Rahmen seiner Berechtigungen
Mitglied	Fragt in der Regel Titel an und sieht die eigenen Anfragen

Berechtigung	Was sie erlaubt	Neuer Admin	Neues Mitglied
Request titles (Titel anfragen)	Anfragen stellen	Ja	Ja
Requests approved without waiting (Anfragen ohne Warten genehmigt)	Anfragen überspringen die Genehmigung	Ja	Nein
Approve or turn down requests (Anfragen genehmigen oder ablehnen)	Über die Anfragen anderer entscheiden	Ja	Nein
Run the Library (die Bibliothek betreiben)	Suchen, ordnen und die Arbeit an der Bibliothek verwalten	Ja	Nein
Change settings (Einstellungen ändern)	Gewöhnliche Einstellungen öffnen und ändern	Nein	Nein

Wer was vergeben darf:

Nur der Besitzer lädt einen Admin ein oder macht jemanden dazu.
Ein Admin lädt Mitglieder ein und ändert sie, und er vergibt nur Berechtigungen, die er selbst hat.
Niemand ändert die eigene Rolle oder die eigenen Berechtigungen.

Eine Person ändern

Öffne Settings > Users and roles und wähle die Person.
Ändere die Rolle oder die Berechtigungen. Eine neue Rolle setzt die Haken bei ihren Standardberechtigungen, bevor du speicherst.
Optional: Lege Wochenlimits für Anfragen zu Filmen, Serien und Musik fest, jeweils 0 bis 1000. Leer gilt der Standard aus Settings > Request rules (Einstellungen > Anfrageregeln); 0 bedeutet kein Limit. Wer genehmigen darf, hat kein Limit.
Klicke auf Save (speichern).

Turn off (ausschalten) meldet die Person überall ab, entfernt ihre API-Schlüssel und sperrt die Anmeldung, bis du sie wieder einschaltest. Das Konto bleibt.

Diese Änderungen brauchen eine Anmeldung mit Passwort. Wenn du über die Abkürzung über das lokale Netzwerk hereingekommen bist, melde dich zuerst mit deinem Passwort an.

Zwei-Faktor-Anmeldung einrichten

Jede Person macht das für ihr eigenes Konto.

Öffne My account (Mein Konto), suche Two-factor (Zwei-Faktor) und klicke auf Set up (einrichten).
Füge das Konto einer Authenticator-App hinzu, mit dem angezeigten Link oder Schlüssel.
Gib den 6-stelligen Code aus der App ein.
Bewahre die 10 Backup-Codes an einem sicheren Ort auf. Du siehst sie nur jetzt; jeder funktioniert einmal.

Um neue Backup-Codes zu erstellen oder Zwei-Faktor auszuschalten, gib einen aktuellen Code aus der App oder einen unbenutzten Backup-Code ein. Neue Codes ersetzen die alten.

Optionen

Zwei-Faktor für Admins verlangen

Der Besitzer schaltet das unter Settings > Sign-in and security (Einstellungen > Anmeldung und Sicherheit) ein. Ein Admin ohne Zwei-Faktor kann dann nur My account öffnen, bis er es eingerichtet hat. Mitglieder sind nicht betroffen.

Profilbild

Jeder kann unter My account > Profile picture (Mein Konto > Profilbild) eines festlegen: JPEG, PNG oder WebP, bis 5 MB. HolyArrs schneidet das mittlere Quadrat auf 256 mal 256 Pixel zu. Remove (entfernen) stellt wieder farbige Initialen ein.

Wenn es nicht funktioniert

Symptom: Ein Einladungslink funktioniert nicht. Ursache: Er wurde benutzt, ist abgelaufen oder wurde zurückgezogen, oder sein Ersteller ist kein aktiver Besitzer oder Admin mehr. Lösung: Erstelle einen neuen. Die Liste Invite links (Einladungslinks) zeigt den Stand jedes Links; der Besitzer kann jeden offenen Link zurückziehen, ein Admin nur die eigenen.

Symptom: Ein Admin kann bei einer Berechtigung keinen Haken setzen. Ursache: Admins vergeben nur Berechtigungen, die sie selbst haben. Lösung: Frag den Besitzer.

Symptom: Jemand hat seinen Authenticator und seine Backup-Codes verloren. Ursache: Es ist kein Code mehr zum Anmelden übrig. Lösung: Der Besitzer setzt Zwei-Faktor für einen Admin oder ein Mitglied zurück; ein Admin setzt es für ein Mitglied zurück. Die Person wird überall abgemeldet, meldet sich mit ihrem Passwort an und richtet es neu ein. Für den Besitzer siehe Passwort vergessen; reset-owner schaltet auch die Zwei-Faktor-Anmeldung des Besitzers aus.

Für Fortgeschrittene

Bild-API

Route	Was sie tut
`PUT /api/v1/account/avatar`	Das Bild als Body. Antwortet mit `{"avatar": "<address>"}`. 413 über 5 MB, 415, wenn es kein JPEG, PNG oder WebP ist
`DELETE /api/v1/account/avatar`	Entfernt dein Bild
`GET /api/v1/users/{id}/avatar`	Das Bild einer Person oder 404

GET /api/v1/auth/me und GET /api/v1/users enthalten avatar oder null. Änderungen brauchen den üblichen CSRF-Header; ein API-Schlüssel braucht den Scope write.