The client imports its backend from a module named `dvs_enc`, but the
repository only shipped that backend as `qtmain.py`. Starting the application
from a fresh clone therefore failed immediately:
ModuleNotFoundError: No module named 'dvs_enc'
`dvs_enc.py` is now included. It carries the same content as `qtmain.py`, so
the import resolves to the identical implementation.
Verified end to end:
- without dvs_enc.py: import qtmain raises ModuleNotFoundError
- with dvs_enc.py: import qtmain succeeds, all 14 backend classes present
Functional tests against a clean copy of the repository pass: text
round-trip, 4096-byte binary round-trip, HMAC authentication, AccountDB and
HistoryDB construction.
Also exercised the full client/server protocol against a live relay: register,
login, create group, join group, and ciphertext relay between two clients.
The relay forwards the payload verbatim without inspecting it.
Documentation
- README: new "Module layout" section explaining why both files are required,
and what the failure looks like when dvs_enc.py is absent; repository layout
and troubleshooting table updated to match
- CHANGELOG: structure table updated
2.6 KiB
Changelog
All notable changes to this project are documented in this file.
The format follows Keep a Changelog, and this project adheres to Semantic Versioning.
3.0.0 — 2026-09-27
First release as a standalone repository. The application code is unchanged from the version previously distributed inside the ChaosCrypt repository; this release separates it into its own project with its own documentation and licence.
Added
README.md— overview, architecture, installation, running instructions, data locations, security properties and troubleshooting.SECURITY.md— threat model, protected properties, cryptographic building blocks, and a detailed list of known limitations.LICENSE— MIT..gitignore— excludes application data, session tokens, local databases and media from version control.
Changed
- Distributed as its own repository rather than a subdirectory of ChaosCrypt.
- Documentation written specifically for this application, rather than inheriting the cipher's documentation.
Structure
| File | Role |
|---|---|
qtmain.py |
PyQt5 client together with the complete backend |
dvs_enc.py |
The backend module that qtmain.py imports at runtime |
server.py |
Optional central relay server, standard library only |
dvs_enc.py carries the same content as qtmain.py. The client imports its
backend classes from dvs_enc, so both files must be present in the same
directory or startup fails. Shipping it explicitly makes the package complete
on its own.
Notes
The application code is byte-for-byte identical to the version shipped with ChaosCrypt 2.0.0. No functional changes were made in this release.
2.0.0 — 2026-08-26
Released as part of the ChaosCrypt project.
Added
- End-to-end encrypted chat on top of the ChaosCrypt cipher.
- Two group modes: direct peer-to-peer, and a central relay for NAT traversal.
- Voice messages: record, encrypt, transmit, decrypt, play.
- Image and arbitrary file transfer, encrypted like any other payload.
- Group management: create, join, rename, announcements, kicking members, join approval.
- Message withdrawal within a time window.
- Per-user keys for member authentication, preventing impersonation.
- SQLite-backed history that survives restarts.
- HMAC integrity checking on every message.
- PyQt5 interface with rounded, adaptive message bubbles.
- Account and history storage in SQLite, with salted password hashing.