Skip to main content

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

Project description

logo

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-1.0.0.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-1.0.0-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pixelpuzzle-1.0.0.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-1.0.0.tar.gz
Algorithm Hash digest
SHA256 1268af43de4679865347649d820e76a74d6390616c2a72b45e43d0d5bd385e4d
MD5 a5e456d7460fd4963fe4468921cc4c05
BLAKE2b-256 26f5b511a11c510925ba9912fc2c73e7f4bcc1c71e1d4c2d79f2280f250ea7a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for pixelpuzzle-1.0.0.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-1.0.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for pixelpuzzle-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 241dc3d6bce8bf25b4cd20e925eb72846ff99a2c56b86fcbb96a6cef7b53aa26
MD5 d0ff82941a241c287904a2ecff8426a8
BLAKE2b-256 04ca97c48339fd4056a137517dfeb1715fbab1ae880d55d6fb4ee6880a6dbccb

See more details on using hashes here.

Provenance

The following attestation bundles were made for pixelpuzzle-1.0.0-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