SteganographierGUI

Hide files into MP4/MKV files

Please make sure you understand the meaning of the word "file extension" before watching the following tutorial. If you don't understand, please first search for "how to change file extension"

If it's still MP4 after changing the extension, that means file extension display is not enabled, please still search for the above content

Can't extract (|why is it a video|wrong password|file corrupted|need split volumes|etc.)

Change the MP4 extension to .zip and use WinRAR to extract

Change the MP4 extension to .zip and use WinRAR to extract

Change the MP4 extension to .zip and use WinRAR to extract

---

Brief usage instructions for Steganographier

This software can turn files or folders into archives and "hide" them inside MP4/MKV videos, disguising them as videos. This operation is called steganography, and the archive disguised as a video is called a steganographic file. When the generated steganographic video is played with a player, it's just an ordinary video; but if you change the extension to .zip, you can use extraction software to extract the hidden files inside.

Two operation modes are supported:

• GUI mode: Just double-click to run, drag files in, one-click steganography or de-steganography, the simplest.
• CLI mode: Operate via command-line parameters, suitable for batch processing or integration into other tools.

Common extraction methods:

• WinRAR: Directly change the extension to .zip and extract (WinRAR6 recommended).
• 7-zip/Bandizip: Open with # mode, or extract via command line.
• Mobile: Use RAR on Android, use 解压专家 (Extraction Expert) on iOS.

Auxiliary features:

• Password book: Write commonly used passwords line by line in modules/PW.txt. The program will automatically try to match them during de-steganography, saving you from manual input.
• Hash modification: You can change the file hash before uploading to cloud storage to avoid chain-reaction bans.
• Captcha generation: Convert extraction codes into captcha images to prevent crawling by bots.
• Right-click menu integration: One-click add to right-click operations, as convenient as extraction software.

---

Other de-steganography methods (match according to the extraction software you use)

---

Updates

2026/09/20 Update version 1.3.11 (full record see CHANGELOG.md)

⚠️ 1.3.10 has major issues and is an intermediate product of the transition; not recommended for use. The right-click menu in that version cannot be registered under any installation path (it directly errors when the path contains spaces, and silently writes incorrect values when it doesn't), and the CLI will write a self-containing archive and freeze when the input path ends with a directory separator. Please use 1.3.11 directly; if you already installed 1.3.10, just overwrite-install it. User data (modules\PW.txt, config.json, logs\) will not be overwritten.

1. Fixed the issue where the CLI temporary archive wrote itself into itself, causing the size to balloon and freeze.
2. Rewrote the registry writing for the right-click menu, no longer passing parameters through the command line; fixed the defect in v1.3.10 where "it's installed but the right-click does nothing", and verified on paths containing spaces, Chinese characters, &, !, ^.
3. The installation interface returns to the look and text of v1.3.9 (author's original assets, EULA based on 1.3.9, clean-then-install), and adds Simplified Chinese / English bilingual support, automatically selected according to system language.
4. Upgrades and reinstallations no longer overwrite modules\PW.txt, config.json, logs\; silent installation no longer pops up dialogs.
5. Release package directory consolidation: runtime libraries moved into _internal/, right-click menu implementation moved into context-menu/, release root directory reduced from 10 directories / 73 files to 6 directories / 8 files.

---

2026/08/18 Update version 1.3.10 (⚠️ has major issues, not recommended for use, see above for details)

1. When de-steganography encounters files with the same name, it can automatically rename (GUI adds a checkbox option, CLI provides --auto-rename).
2. CLI mode no longer depends on Tkinter, so command-line functionality can be used directly in environments without a graphics library.
3. The right-click menu install/uninstall scripts have been fully rewritten, supporting installation paths containing spaces, Chinese characters, and special characters like !.
4. Release packages are now automatically built by GitHub Actions, with a SHA256SUMS checksum file attached; since v1.3.10 the official package no longer bundles DownKyi (Bilibili video download tool), please obtain it yourself via the link in §5.2 above.

---

2025/06/28 Update version 1.3.1

Added working mode mp4(zarchiver). Steganographic files generated in this mode can be extracted by zarchiver and 解TMD压 and other extraction software that scans archives from the beginning, but cannot be extracted by WinRAR which scans archives from the end. Use as appropriate.

---

Steganographier — a dual GUI & CLI MP4/MKV steganography program

Author: 层林尽染

Usage Instructions

This program can hide files or folders into video files, or extract hidden files or folders from video files. The program supports both command-line interface (CLI) and graphical user interface (GUI) modes.

1. GUI mode: [Recommended] Double-click to run the program directly, without any parameters. For GUI usage details, see the demo video.

2. CLI mode: Run the program with the following parameters:

   -i, --input     Specify the path of the input file or folder. If no parameter tag is used, the program will treat the first unknown parameter as the input path.
   -o, --output    1. Specify the output filename (including extension) [or] 2. Specify the output path (defaults to original filename + "_hidden.mp4/mkv").
   -p, --password  Set password (no password if not specified).
   -t, --type      Set output file type (defaults to mp4), supports both mp4 and mkv formats.
   -c, --cover     Specify the cover MP4 video (if not specified, the program searches in the following order:
                      - In the cover_video folder in the same directory as the program
                      - In the directory where the program is located
                      - In the directory where the input file or directory is located)
   -r, --reveal    Perform de-steganography (if the input file is not a steganographic file, no operation is performed)
   

Usage Examples

1. Steganography of a file:

   python Steganographier.py -i "input.txt" -o "output.mp4" -p "password" -t "mp4" -c "cover.mp4"
   python Steganographier.py -i "input.txt" -o "outputFolder" -p "password" -t "mp4" -c "cover.mp4"
   

2. Steganography of a folder:

   python Steganographier.py -i "inputFolder" -o "outputFolder" -p "password" -t "mp4"
   python Steganographier.py -i "inputFolder" -o "output.mp4" -p "password" -t "mp4"
   

3. De-steganography to extract files:

   python Steganographier.py -i "input.mp4" -r -p "password"
   

4. If only the input file is specified, default settings are used: