Skip to main content

Text encoding type classifier

Project description

whatenc

PyPI License

Text encoding type classifier.

whatenc is a command-line tool that identifies the encoding or transformation of a given string or file.

The model is trained on text samples from the English, Greek, Russian, Hebrew, and Arabic Wikipedia corpora, chosen to represent a diverse set of writing systems (Latin, Greek, Cyrillic, Hebrew, and Arabic scripts). Each line is encoded using multiple encoding schemes to generate labeled examples.

How It Works

whatenc uses a character-level 1D Convolutional Neural Network trained directly on bigram token sequences.

Each training sample is represented as:

  • bigram of characters, padded to a fixed maximum length
  • a true length scalar feature, allowing the network to learn relative string lengths

This neural approach achieves near-perfect classification accuracy after only a few epochs.

Supported Encodings

whatenc currently recognizes the following formats and transformations:

Category Encodings
Base encodings base32, base64, base85, hex, url
Text ciphers morse
Compression gzip64
Hash digests md5, sha1, sha224, sha256, sha384, sha512

Installation

You can install whatenc using pipx:

pipx install whatenc

Usage

whatenc hello
whatenc samples.txt

Examples

[+] input: ZW5jb2RlIHRvIGJhc2U2NCBmb3JtYXQ=
   [~] top guess   = base64
      [=] base64   = 1.000
      [=] base85   = 0.000
      [=] plain    = 0.000

[+] input: hello
   [~] top guess   = plain
      [=] plain    = 1.000
      [=] md5      = 0.000
      [=] base64   = 0.000

[*] loading model
[+] input: האקדמיה ללשון העברית
   [~] top guess   = plain
      [=] plain    = 1.000
      [=] base64   = 0.000
      [=] base85   = 0.000

[*] loading model
[+] input: bfa99df33b137bc8fb5f5407d7e58da8
   [~] top guess   = md5
      [=] md5      = 0.999
      [=] sha1     = 0.001
      [=] sha224   = 0.000

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

whatenc-0.7.1.tar.gz (7.9 MB view details)

Uploaded Source

Built Distribution

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

whatenc-0.7.1-py3-none-any.whl (7.9 MB view details)

Uploaded Python 3

File details

Details for the file whatenc-0.7.1.tar.gz.

File metadata

  • Download URL: whatenc-0.7.1.tar.gz
  • Upload date:
  • Size: 7.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for whatenc-0.7.1.tar.gz
Algorithm Hash digest
SHA256 294ba8ac984b19749a972066e8530a167d2a1b087594a51d5f5a7ed8461666c1
MD5 7e46fd88e9ab04ce094d5149a33415c7
BLAKE2b-256 e8b99e73d51204e79a0b9f74acd961ca0ce3ca7e7a5ce3b0c1597799764e5973

See more details on using hashes here.

File details

Details for the file whatenc-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: whatenc-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 7.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for whatenc-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bd7ff85cbbbebeac48a12c0a46d5036241d63d7eaf4cb802611a88de4172d9e4
MD5 2caedc74d3b4eee97a926e510912f543
BLAKE2b-256 000b744806389a00668e3f3a7b11e3c5343f667fba20a41491bee00f77b2553d

See more details on using hashes here.

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