Metadata-Version: 2.4
Name: as4pgc
Version: 1.5
Summary: Audio Steganography: compress, encrypt and hide a secret file inside an audio file (MP3, WAV, OGG, FLAC, OPUS, ..)
Home-page: https://github.com/ClarkFieseln/AS4PGC
Author: Clark Fieseln
Author-email: 
License: MIT
Project-URL: Source, https://github.com/ClarkFieseln/as4pgc
Keywords: steganography,stego,audio,hide,cryptography,encryption,compression,security,cybersecurity,mp3,flac,ogg,opus,wav,linux
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Security
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: soundfile
Requires-Dist: matplotlib
Requires-Dist: cryptography>=46.0.3; python_version >= "3.8"
Requires-Dist: cryptography>=39.0.0; python_version < "3.8"
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: bitarray
Requires-Dist: tinytag
Requires-Dist: simpleaudio
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: summary

# as4pgc
Hide files inside audio files.

Use "Audio Steganography for Pretty Good Concealment" to compress, encrypt, and hide small files of any type inside compressed audio files (e.g. MP3, FLAC, OGG, OPUS) or inside uncompressed files (.WAV).

## Installation
- Install system dependencies:

  ```bash
  sudo apt update
  sudo apt install ffmpeg sox libsox-fmt-mp3 libsox-fmt-all python3-tk python3-pyqt5
  ```
- For development (optional):

  ```bash
  sudo apt install python3-dev build-essential libasound2-dev ffmpeg sox libsox-fmt-mp3 libsox-fmt-all python3-tk python3-pyqt5
  ```
- Upgrade Python tooling and install the package:

  ```bash
  pip install --upgrade pip setuptools
  pip install as4pgc
  ```
For Windows you can download ffmpeg from here:
https://www.ffmpeg.org/

WARNING: the current version was not yet tested on Windows, e.g. installation and use of sox.

## How to use it?
Hide a file of any type inside an .mp3 file:
```sh
  as4pgc -w secret.zip carrier.mp3
```
Use option -p to activate plots and track signal processing steps.

Use option -v to output details.
```sh
  as4pgc -p -v -w secret.zip carrier.mp3
```

Then recover the hidden file:
```sh
  as4pgc -r stego.mp3
```

Use the option -h for more information:

```sh
  as4pgc -h
```

Configuration settings can be adapted in config.ini.
For detailed documentation check the Article in Code Project. The link is provided further below.

## PyPi Project

https://pypi.org/project/as4pgc/

## Article in Code Project

https://www.codeproject.com/Articles/5313626/Audio-Steganography-for-Pretty-Good-Concealing-AS4

## Article in GitHub

https://github.com/ClarkFieseln/AS4PGC

## License

(c) 2026 Clark Fieseln

This repository is licensed under the MIT license. See LICENSE for details.
