Skip to content

kisscool-fr/pysteg

Repository files navigation

PySteg app icon

PySteg

CI

A simple GUI for steganography: hide and reveal secret messages in images, with optional AES-256-GCM encryption and Argon2id key derivation.

Built as a replacement for Steganozorus © 2002 – Thomas Nerrant.

Sponsor

If you find this project useful, consider buying me a coffee.

Features

  • Hide and reveal messages in image files using LSB or EXIF steganography
  • AES-256-GCM encryption with Argon2id key derivation from a shared secret
  • Plain text mode to hide a message without encryption (useful for testing or low-risk payloads)
  • Desktop GUI built with PyQt6

Supported image formats

Format Technique
PNG, BMP LSB (least significant bit)
JPEG, TIFF EXIF header

When hiding text, the output file is saved next to the source image with a _hidden suffix (for example, photo.pngphoto_hidden.png).

Requirements

  • Python 3.13
  • uv (recommended) or pip
  • just (optional, for recipe commands)

Installation

First-time setup (creates a virtual environment with the Python version from .python-version):

just init
just install

Or with uv directly:

uv sync

Usage

just run

Or:

uv run -m app
  1. Choose Hide or Reveal mode.
  2. Enter the text to hide, or leave the field empty in reveal mode.
  3. Enter a shared secret (at least 8 characters), or enable plain text mode to skip encryption.
  4. Select a cover image and run the action.

Development

Common tasks via just:

just test      # run pytest
just format    # lint and format with ruff
just typing    # type-check with pyright
just ci        # full local CI pipeline

List all recipes with just --list.

Screenshot

PySteg main window

Roadmap

  • Choose output file name
  • Add support for more encryption algorithms
  • Add support for keyfiles
  • Audio and video support, drag & drop
  • Deniability support
  • More languages
  • Binary release
  • Design improvements

License

MIT

Credits

KisSCoOl

About

A (very) basic GUI for steganography operation

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors