Skip to main content

Encode/decode images using Base64 or shuffle/recover the pixels of images.

Project description

PixelPuzzle

GitHub Actions Workflow Status PyPI - Python Version PyPI - Version PyPI - Wheel PyPI - Downloads GitHub License

Encode/decode images using Base64 or shuffle/recover the pixels of images.

Motivations

This repository is a renewed implementation of Python code I saw a long time ago on CoolApk:

import matplotlib.pyplot as plt
import numpy as np
from PIL import Image

# Get the three-dimensional pixel channel matrix of the image
img = np.array(Image.open("C:/Users/user/Downloads/test.png"))
# First dimension
row_len = img.shape[0]

# Shuffle the dimension indices
row_index = np.random.permutation(row_len)
# Generate the chaotic image
img_chaos = img[row_index, :, :]

# Use sorting to unshuffle the image
img_sort = img[np.sort(row_index), :, :]

# Plot the chaotic and unshuffled images
plt.figure('Chaotic and Unshuffled Images')
plt.subplot(121)
plt.imshow(img_chaos)
plt.subplot(122)
plt.imshow(img_sort)
plt.show()

And it can also be seen as an implementation of similar functions of the Android application 图片混淆 in Python.

Installation

PixelPuzzle can be installed from PyPI:

pip install pixelpuzzle

or download the repository and run:

pip install .

as of the repository root folder.

Examples

  • The original image:

    The original image

  • The shuffled image (using the random seed 0721):

    The shuffled image

  • The recovered image:

    The recovered image

Packaging

The binaries are created with Nuitka PyInstaller:

# Package it on Linux
pyinstaller --name PixelPuzzle --onefile -p pixelpuzzle pixelpuzzle/__main__.py

# Package it on Windows
pyinstaller --name PixelPuzzle --onefile --icon python.ico -p pixelpuzzle pixelpuzzle/__main__.py

Web Applications

Deploy Pixel Puzzle on Vercel.

Similar Projects

Here are some links to other similar projects that I am aware of:

Copyrights

PixelPuzzle is a free, open-source software package (distributed under the GPLv3 license). The sample image used is downloaded from satchely doki doki literature club! natsuki. The Python icon is downloaded from python.ico.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pixelpuzzle-0.4.3.tar.gz (17.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pixelpuzzle-0.4.3-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

Details for the file pixelpuzzle-0.4.3.tar.gz.

File metadata

  • Download URL: pixelpuzzle-0.4.3.tar.gz
  • Upload date:
  • Size: 17.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pixelpuzzle-0.4.3.tar.gz
Algorithm Hash digest
SHA256 d411678e878fc63092caa9caa804a863c5ed71797e6688804fe502fc203c16e6
MD5 c12014cb48ee0005a2d43eb72c287532
BLAKE2b-256 348bce2813bd8238e432dad89900d4837f4dd77ed32b9374d7f3391bf675bc24

See more details on using hashes here.

Provenance

The following attestation bundles were made for pixelpuzzle-0.4.3.tar.gz:

Publisher: python-publish.yml on ZhanZiyuan/PixelPuzzle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pixelpuzzle-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: pixelpuzzle-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 18.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pixelpuzzle-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0f2164c7298d2d9eabda8ced09ed336b11ed381c317619903d7bb7efd70b3f74
MD5 65c8f775fc3f8755ac68005a560afc87
BLAKE2b-256 1f90b68dda2e7c6dbdfc1e9774b219df5bf46e8680acd29a2d5ba4ddb2c65961

See more details on using hashes here.

Provenance

The following attestation bundles were made for pixelpuzzle-0.4.3-py3-none-any.whl:

Publisher: python-publish.yml on ZhanZiyuan/PixelPuzzle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page