An admin UI for The Lounge, manage users and uploads
  • Go 53.1%
  • HTML 26.1%
  • JavaScript 17.5%
  • Handlebars 1.7%
  • Shell 1.6%
Find a file
2026-02-09 15:00:34 -08:00
.forgejo/workflows upload using release 2026-02-09 15:00:34 -08:00
html new small icon 2026-02-04 16:27:25 -08:00
static new small icon 2026-02-04 16:27:25 -08:00
templates new small icon 2026-02-04 16:27:25 -08:00
.gitignore super good progress on the Go rewrite 2025-11-28 03:46:30 -08:00
config.sample-different-user.json add user creation dialog 2025-12-23 20:56:36 -08:00
config.sample.json add user creation dialog 2025-12-23 20:56:36 -08:00
get_extern.sh add bootstrap icons, make logout a button instead of a tab 2025-12-18 21:59:59 -08:00
go.mod add login 2025-12-17 21:22:04 -08:00
go.sum add login 2025-12-17 21:22:04 -08:00
LICENSE Initial commit 2025-05-17 16:48:22 -07:00
main.go tmp then move 2026-01-31 18:02:43 -08:00
README.md add screenshot for reset 2026-02-04 16:36:42 -08:00

thelounge-web-admin

An admin UI for The Lounge, used for configuring the instance.

Warning

  1. The admin UI will not support Public Mode because a user system won't exist when it's enabled.
  2. Unless you are comfortable with using a remote filesystem like sshfs, Thelounge Web Admin should run on the same box running thelounge.
  3. Make sure to run the service as the same user running thelounge, if you can't (because of e.g. Docker, remote filesystem), you can set the uid and gid properties in json config (get the correct values by using stat /etc/thelounge/)
  4. This is an unofficial project.

Running

Requirements

  • The Lounge instance (duh)
  • Go (for building)
  • A JSON config file, see config.sample.json.
    • admins: List of thelounge users marked as administrators that can access the admin panel
    • instanceUrl: URL to your thelounge instance
    • rootPath: Path of thelounge data directory, usually /etc/thelounge
    • dbPath: Where to put the web admin's database, /etc/thelounge/tlwa.db is a perfectly fine location.
    • uid: Optional, the UID to create user files with, must also have gid set (should be the same as thelounge user)
    • gid: Optional, the GID to create user files with, must also have uid set (should be the same as thelounge user group)

Build

./get_extern.sh
go build .

Run

Progress

  • Login process
  • Dashboard
    • Users
    • Uploads
    • Logs
  • User actions
    • Create
    • Reset password
    • Delete
  • Uploads actions
    • Scan
    • View
    • Delete
    • Pagination
  • Logs
    • List
    • Clean
    • Migrate
    • Export

Screenshots

Login & Logout

Screenshot of the login screen

Screenshot of the logout dialog

Users

Screenshot of the Users page

Screenshot of the Create User form

Screenshot of the Reset User form

Screenshot of the Delete User dialog

Uploads

WiP