Change how the app looks, sounds, and works — plus your security vault.
Centralized config hub: appearance (theme, font, layout), notifications, privacy, chat behavior, keybinds, accessibility, audio/video, DND mode, storage management. Includes Server Info panel (live stats from /api/stats). Vault section provides AES-256-GCM encrypted credential storage with PBKDF2 key derivation (600k iterations), cloud sync via /api/vault/sync, and auto-lock timer.

Your settings. Change how things look and work — colors, sounds, notifications, and more. Make it yours.

Appearance

Customize how HumanityOS looks and feels.

Theme
Color Scheme Choose light, dark, or match your OS
Accent Color Primary highlight color used throughout the UI
Background Intensity How dark the background panels appear
Page Hints
Show Simple (💡) Plain-language explanations on every page
Show Expert (🔬) Technical details for developers and power users
Typography
Font Size Base text size across the app
Compact Mode Reduce padding and spacing for more content
Nav Bar
RGB Border Animation Cycling color border on the active nav tab
Show Nav Tooltips Display label tooltips when hovering nav icons

Notifications

Control when and how HumanityOS alerts you.

Messages
Direct Messages Notify when you receive a direct message
Group Messages Notify when someone posts in a group you're in
Mentions Notify when someone @mentions you
System
Quest Reminders Remind you about overdue quests
Calendar Events Alert before scheduled calendar events
Notification Sound Play a sound when notifications arrive

Privacy

Control who can see your information and contact you.

Visibility
Who Can Message Me Restrict incoming direct messages
Show Online Status Let others see when you're online
Read Receipts Let senders see when you've read their messages
Show in Discovery Allow others to find your profile in search
Data
Local-Only Storage Keep skills, inventory, and logbook data on this device only
Analytics Share anonymous usage data to improve HumanityOS

Chat

Configure your messaging and network chat experience.

Messages
Message Preview Show a preview of messages in notifications
Send on Enter Press Enter to send; Shift+Enter for new line
Show Timestamps Display time next to each message
Message Grouping Group consecutive messages from the same person
Relay
Custom Relay Server Connect to an alternative relay instead of the default
Voice
Input Mode How your microphone activates in voice channels
Push-to-Talk Key Hold this key while in PTT mode to transmit
V

App

General application behavior and preferences.

Regional
Language Display language for the interface
Date Format How dates are displayed throughout the app
Time Format
Behavior
Launch to Chat Open the Network chat on app start
Auto-Save Interval How often to auto-save local data

Account

Manage your HumanityOS identity and credentials.

Identity
Display Name Your name shown to others in the network
Public Key Your Ed25519 identity key (read-only)
Not connected
Profile
Edit Full Profile Avatar, bio, pronouns, social links, streaming
Open Profile →
Danger Zone
Clear All Local Data Wipe skills, inventory, logbook, quests, and calendar from this device
Reset Settings Restore all settings to their defaults

Advanced

Developer and power-user options.

Debugging
Show Debug Panel Display real-time connection and performance info
Console Logging Enable verbose logging to browser console
Operations Panel System health, deploy logs, and moderation tools
Open Ops →
Export / Import
Export All Data Download a JSON backup of all local HumanityOS data
Import Data Restore from a previously exported JSON backup
App Cache
Clear App Cache & Reload Forces every page to re-download fresh — use when an update isn't showing up. Keyboard shortcut: Ctrl+Shift+Delete

HumanityOS — loading version…

Keyboard Shortcuts

Customize every keyboard shortcut. Click a key binding and press your new key combo. All shortcuts are saved to your browser.

Accessibility

Make HumanityOS easier to use for everyone. These settings help with vision, motion, and navigation.

Motion & Animation
Reduce Motion Turn off animations and transitions throughout the app
Disable RGB Effects Turn off all color-cycling and glow effects
Vision
High Contrast Increase contrast between text and background
Large Cursor Focus Show a thick visible outline around the focused element
Dyslexia-Friendly Font Use a font with more distinct letter shapes
Screen Reader
Enhanced ARIA Labels Add extra descriptive labels for screen readers

Audio & Video

Choose your camera, microphone, and speakers. Test them here before joining a voice channel.

Microphone
Input Device Which microphone to use
Input Level Visual meter showing mic volume right now
Input Gain Boost or reduce your mic volume
100%
Speaker
Output Device Which speaker or headphones to use
Output Volume Master volume for all incoming audio
100%
Camera
Camera Device Which webcam to use
Video Quality Resolution for your camera feed
Camera Preview Check how you look before going live

Security

Protect your identity and manage your devices. Your Ed25519 key is your passport — keep it safe.

Key Protection
Passphrase Lock Encrypt your private key in this browser with a passphrase so no one else can use it
Checking…
Auto-Lock Timer Automatically lock your key after being idle
Devices
Manage Linked Devices See all devices using your identity, label them, or revoke access
My Devices →
Backup & Recovery
Backup Identity Key Export an encrypted backup of your private key that you can restore on another device
Backup →
Recovery Seed Phrase 12-word phrase that can restore your identity if all devices are lost
View Seed →

Do Not Disturb

Silence notifications and hide your online status. Set quiet hours so you aren't interrupted during sleep or focus time.

Presence
Status Mode Controls what others see about your availability
Custom Status A short message shown next to your name
Quiet Hours
Enable Quiet Hours Mute all notifications during a scheduled time window
Start Time
End Time
Exceptions
Allow DMs from Friends Friends can still reach you even during quiet hours
Allow Mentions Still notify on @mentions during quiet hours

Storage

See how much space your data uses on this device. Clear individual modules or manage what gets synced to the server.

Local Storage Usage

Calculating…

Server Sync
Vault Sync Encrypted vault blob backed up to the relay server
Unknown
System Profile Sync Hardware info backed up to the relay server
Unknown
Clear Individual Modules
Clear Notes Remove all local encrypted notes
Clear Inventory Remove all inventory items
Clear Logbook Remove all journal entries
Clear Calendar Remove all calendar events

Server Info

Live server stats, roles and permissions, rate limits, and chat commands reference.

🖥️ Server Stats

Online
Registered
Uptime
Version

🛡️ Roles & Permissions

👤 Unverified

Chat (rate limited) · Voice · View channels
Upload files · DM · Create channels · Follow/unfollow

✦ Verified

All above + Upload files · DM friends · Follow/unfollow

💎 Donor

Same as Verified + 💎 badge · Priority support

🛡️ Moderator

All above + DM anyone · Kick/mute/ban · Create/edit channels · Manage reports

👑 Admin

All above + Verify/unverify · Promote/demote · Lockdown · Wipe · Server config

🤝 Social System

Viewers️ Follow

One-way — shows you care. Use /follow <name>. Right-click a user for quick follow.

🤝 Friends (Mutual Follow)

When both users follow each other, they become friends. This unlocks DMs and shows the 🤝 badge.

🚫 Block

Client-side — hides their messages from your view. Use /block <name>.

⏱️ Rate Limits

Messages: Fibonacci rate limiting (1,1,2,3,5,8… second delays on rapid posting)
New accounts: 5s minimum delay for first 10 minutes
Uploads: 2/minute, 4 image max per user (FIFO — oldest replaced)
API: 10 req/s general, 5 req/s for read endpoints

📜 Commands Reference

👥 Social

/follow <name> — Follow a user
/unfollow <name> — Unfollow a user
/block <name> — Block a user
/unblock <name> — Unblock a user
/blocklist — Show blocked users

💬 DMs & Groups

/dm <name> <msg> — Send a direct message
/dms — List DM conversations
/group-create <name> — Create a group chat
/group-join <code> — Join group by invite code
/group-invite — Copy current group's invite code
/group-leave — Leave current group
/friendcode — Generate a one-time friend code (auto-mutual follow)
/redeem <code> — Redeem a friend code (both users follow each other)

✏️ Profile

/bio <text> — Set your bio
/social <platform> <handle> — Set social link
/profile — Edit profile
/name <name> — Change display name

📌 Pins

/pin — Pin the last message (mod/admin)
/unpin <N> — Unpin by index (mod/admin)
/mypin — Pin your last message (for yourself)
/unmypin <N> — Unpin your pin by index
/pins — View pins

📞 Voice

/call — Start a voice call (or use 📞 button)

🛡️ Moderation

/kick <name> — Disconnect a user
/mute <name> — Mute a user
/ban <name> — Ban a user
/report <name> [reason] — Report a user

👑 Admin

/verify <name> — Verify a user
/unverify <name> — Remove verified
/mod <name> — Promote to moderator
/unmod <name> — Remove moderator
/donor <name> — Set donor role
/lockdown — Toggle registration lock
/channel-create <name> [desc] — Create channel
/channel-delete <name> — Delete channel
/wipe — Delete all chat history

🔧 Utility

/help — Show help
/export — Download identity backup
/link — Link another device
/revoke <key> — Remove a device
/users — List all users

Vault

Your encrypted local-first secure storage for passwords, seed phrases, and private notes.

🔐 Create Your Vault

A secure place for passwords, recovery phrases, and private notes — all on your device, all encrypted, none of it visible to anyone but you.

Think of this like a filing cabinet with a combination lock. Only you know the combination. Everything inside is scrambled into unreadable gibberish — even if someone got into your computer, they would see nothing useful.

We never see any of this. It never touches any server. It lives entirely on your device.

⚠ Choose a passphrase you'll remember. If you forget your vault passphrase, everything inside is gone — there is no "forgot password" because only you hold the key. Make it long and memorable: a phrase or three words you won't forget.

Your passphrase is never stored or transmitted — only a mathematical lock derived from it.

🔒 Vault Locked

Enter your vault passphrase to open your secure storage.

💡 Don't have a vault yet? Create one.

Vault

Your vault is unlocked 🔓

Add anything you want to keep private — seed phrases, passwords, secure notes. Everything is encrypted with your passphrase before it's saved. Nothing leaves your device.

📖 How the vault works

🔒

Your passphrase = your key. When you save an entry, it's scrambled using your passphrase. Only someone who knows that passphrase can unscramble it — not us, not your internet provider, not anyone else.

📱

It stays on your device. Unlike a cloud password manager, this vault lives in your browser's local storage. It doesn't sync across devices automatically — that's a trade-off for maximum privacy. Export a backup if you want to move it somewhere else.

👁️

Secret fields are hidden until you click them. Passwords and seed phrases show as blur by default — tap to reveal. This protects you from someone glancing at your screen.

💾

Back it up. If you clear your browser data, you lose your vault. Use ⬇ Export to download an encrypted copy, or ☁ Sync to save it to the Humanity relay — then ☁⬇ Restore on any other device using the same identity.

Cloud sync is still encrypted. The relay server never sees your passwords or seed phrases — only scrambled data that only you can unscramble with your vault passphrase. You need a Humanity chat identity to use cloud sync (it signs the request to prove it's really you).

New Entry

Type
🌱 Seed Phrase
🔑 Password
📝 Secure Note
🔗 Login
🪙 Custom