Tutorials - User Management
User Roles
FrameTrail has two built-in user roles that control what each user can do:
Admin
- Create, edit, and delete any hypervideo
- Add, edit, and delete overlays and code snippets (which are shared across all users)
- Manage resources in the Resource Manager
- Create and manage user accounts
- Change project-wide settings (theme, layout defaults, collaboration options)
User
- Create and edit their own hypervideos
- Add and edit their own annotations on any hypervideo
- Browse and reuse annotations created by other users
- Upload and link resources to the Resource Manager
- Cannot edit overlays, code snippets, or other users' hypervideos
Quick Links
Note on Modes
User accounts and roles only apply in Server Mode. In Local Folder and In-Memory modes, identity is name-only and there is no access control.
Logging In
Server Mode
Click the Edit button in the top-right corner of the player. A login dialog will appear — enter your username and password. After logging in, you will enter edit mode with the permissions associated with your role.
Local Folder Mode
Click Edit. You will be prompted for a display name only — no password. This name is used to identify your annotations, but there is no authentication or access control.
In-Memory / Guest Mode
Click Edit and log in as a guest. You can view and edit content, but changes are not saved automatically — use Save As to export your work. See Managing Data for export options.
Creating User Accounts (Admin only)
As an administrator, you can create and manage accounts for other users through the User Management panel.
- Log in with your admin account.
- In the titlebar, open Settings and navigate to User Management.
- Click "Add User" and fill in a username, password, and role (admin or user).
- Confirm to create the account. The new user can now log in with their credentials.
Editing and Deleting Users (Admin only)
In the User Management panel, click any user to:
- Change their username or password
- Promote them to admin or demote to user
- Delete the account — note that their annotations and hypervideos remain in the project
You cannot delete or demote your own admin account while logged in.
Project Configuration (Admin only)
The project-wide runtime configuration is stored in _data/config.json. Admins can adjust several settings through the Settings panel in the editor, including:
- Color theme and default layout
- Whether user registration is open or invite-only
- Whether login is required to view hypervideos (or if they are publicly accessible)
- Upload permissions — which roles can upload files
- Collaboration settings for annotation sharing