ButSystem.py (Exclusive) - DedSec Project

Core ButSystem Feature Areas

ButSystem.py brings chats, groups, stories, files, profiles, encrypted records, weather, news, security controls, admin tools, and flexible local or remote access together in one self-hosted interface.

Chats, Groups & Stories

Live direct messages, group chats, saved messages, GIFs, voice notes, file sharing, the discussion room, stories, and call flows where browser and device support allow it.

Security, Access & Control

User approval, device access requests, remembered-device login, optional security-question 2FA, chat PIN locks, online status, reports, admin pages, and appearance or account settings.

Profiles, Vault & Tools

Profile editing, an advanced private file vault, opt-in live locations, encrypted Profiler records with search, import, export, and combine tools, administrator bounty controls, and the built-in Face Detector.

Weather, Links & Sharing

Search weather by place or current location, view detailed forecasts for up to 14 days, and use generated HTTPS, Cloudflared, or Tor links with downloadable QR codes. Vault files can also be shared through controlled links with optional passwords, expiry, and revocation.

All Screens & Buttons (Complete)

Instead of a long button-by-button list, this section explains each ButSystem area the same way the Learn page explains tools: by feature area, what you do there, and what kind of controls you will find when you open it.

Navigation & Menu Flow

The burger menu is the main control hub of ButSystem. From there you move between chats, saved messages, discussion, groups, calls, stories, live locations, files, news, weather, profiles, Profiler, reports, notifications, admin pages, settings, help, and login or logout actions, while the language toggle keeps the interface available in both English and Greek.

Authentication & Access

ButSystem opens through its landing, loading, login, and signup flow, then adds extra access control where needed. That includes user approval, device access requests, remembered-device login, optional security-question two-factor checks, and password recovery or reset actions so access stays tied to approved users and approved devices.

Direct Messages

The DM area is built for day-to-day private conversation. You can open a chat, write and send text, edit or delete messages, search conversation content, attach media or files, use GIFs, record or play voice notes, and work with chat protections such as PIN locks and visible online status where those controls are enabled.

Discussion Room

Discussion works more like a shared stream than a one-to-one chat. It is the place for broader entries, category-based posting, search, refresh, loading more content, and opening a specific entry when you want a calmer shared space separate from normal DMs.

Groups

The Groups area lets users build shared spaces with roles and moderation controls. You can create a group, invite or add members, check the member list, manage owner or admin actions such as promote, demote, or remove, leave a group when needed, and continue the conversation through the related group chat with messages and attachments.

Calls & Live Communication

Where browser support and device permissions allow it, ButSystem includes call flows for starting, joining, accepting, denying, muting, and ending a live call. The exact experience depends on microphone permissions and the current browser environment, so the call layer is treated as a live feature area rather than a static page.

Stories & Live Locations

ButSystem also covers lighter live-sharing tools. Stories provide creation, viewing, and reaction controls, while Live Locations is reserved for opt-in location sharing with start, stop, refresh, and clear consent or warning prompts before location data is actively shared.

Files, Vault & Saved Media

The Files and Vault area works like a private server-style file manager. It supports folders and navigation, normal or chunked uploads with cancellation, search, categories, file-type filters, sorting, previews, opening and downloading, rename, move, bulk actions, deletion, comments, activity history, detailed size, MIME, and date metadata, optional SHA-256, and controlled share links with optional passwords, expiry times, and revocation.

Profile, Account & Appearance

Your own profile area handles identity and account presentation. From there users can view or edit profile data, save changes, upload or remove a profile picture, adjust account settings, control appearance options, and access stronger account actions such as account deletion or the self-destruct danger zone where that workflow is enabled.

Profiler, Bounty & Face Detector

The Profiler side is where ButSystem becomes a structured information workspace. It supports encrypted profiler entries, view and edit flows, local search, export and combine tools, bounty management where that module is enabled, and the built-in Face Detector area used for local face-detection workflows and similarity-style comparison support inside the broader ButSystem environment.

Reports, Admin & Security Settings

The control layer of ButSystem is split across reports, admin pages, and security settings. This is where users create or update reports, where admins approve or deny access and device requests, manage people and user files, and where account holders configure two-factor settings, device-login rules, password-reset paths, privacy options, and other safeguards that keep the workspace organized and controlled.

News & Topic Feed

The News area gives the workspace a dedicated place for topic-based updates without mixing them into private chats. Users can open the feed, move between available topics, refresh the current view, and read updates from the same local interface used for the rest of ButSystem.

Weather & Forecasts

Search by city, village, or postal code, use the device's current location, refresh results, and view current conditions plus forecasts for up to 14 days. The page can show current and apparent temperature, humidity, wind and gusts, precipitation, cloud cover, pressure, rain probability, UV, sunrise, and sunset. Coordinates are used for the request and are not saved by ButSystem.

Generated HTTPS, Cloudflared & Tor Links

At startup, ButSystem serves local HTTPS with a generated self-signed certificate, prints LAN and localhost URLs, and automatically attempts a Cloudflared quick tunnel and a Tor hidden service. The landing page displays whichever links are available and generates a fresh downloadable QR code for each one.

Presence, Delivery & Live State

ButSystem keeps active areas responsive with heartbeat-based online status, unread message counts, delivery and read state, polling for new direct or group messages, and live refresh paths for discussion, locations, calls, and other changing data. This makes the interface feel current without needing a separate desktop client.

Attachments, Previews & Large Uploads

Files are handled according to where they are used. Direct messages, groups, discussion, and stories support the relevant file, image, voice, or media attachments; profiles support profile pictures; and the vault adds previews, metadata, organization, sharing, and chunked transfer for larger uploads so they are not forced through one fragile request.

Local Data Protection & Persistence

Account records, settings, messages, encrypted text fields, keys, logs, and workspace data are kept in ButSystem's own local folders. The script prefers the phone's shared Homework storage when available so important app state can survive a Termux reinstall, while sensitive text and Profiler content use the built-in encryption layer.

Search, Export & Record Workflows

Several areas are designed for finding, filtering, and moving information instead of only displaying it. Users can search conversations, discussion entries, vault files, reports, and Profiler records; filter and sort the vault; open focused details; import, export, or combine Profiler records; and download attachments when a local copy is needed.

Privacy Pause, Logs & Recovery Controls

The system includes operational safeguards for moments when access must be stopped or reviewed. Privacy pause and resume actions can temporarily protect the workspace, security events are written to local logs, admins can inspect log files, and recovery tools cover forgotten passwords, approved devices, forced sign-out, account deletion, and full reset workflows.

Forgot The Password? Start ButSystem Fresh

Use this only when recovery is impossible and you accept losing every old ButSystem account, password, setting, message, vault file, key, and log. Stop ButSystem first, run the command in Termux, then start ButSystem.py again so it creates a completely fresh workspace.

Warning: this command permanently deletes the saved ButSystem data folders. It does not delete the ButSystem.py script itself.

rm -rf "$HOME/storage/shared/Homework/ButSystem" "/storage/emulated/0/Homework/ButSystem" "$HOME/Homework/ButSystem" "$HOME/ButSystem" "$HOME/.ButSystem_tor"