中文版

PyArmor is a tool used to import or run obfuscated python scripts.

#### Main Features

- Run obfuscated script or import obfuscated module
- Expire obfuscated files
- Bind obfuscated files to harddisk, mac address, ip address etc.

#### Support Platforms

- Python 2.5, 2.6, 2.7 and Python3

- Prebuilt Platform: win32, win_amd64, linux_i386, linux_x86_64, darwin_x86_64, macosx_x86_64

- Embeded Platform: Raspberry Pi, Banana Pi, ts-4600

#### Quick Start

- Download PyArmor

- Extract it to any path, for example, /opt

- Enter /opt/pyarmor/webui, run manager.bat or manager.sh

- A webpage will open in web browser at the same time, do the following steps in this web page:

  - Click tab Project
  - Click button New
  - Type absolute path of python source files in Src, for example, /opt/pyarmor/examples
  - Type Entry Scripts, for example, queens.py
  - Type Output, for example, projects/project-1/dist
  - Click button Build
  - All the obfuscated files would be save in /opt/pyarmor/webui/projects/project-1/dist, enter this path
- Run obfuscated script with command: `python queens.py`

Note that this webui doesn't include all the features of PyArmor, run pyarmor.py in command line to use full features
Project Infromation
Name
Title
Src

Required. Base path for MANIFEST.in to match files.

MANIFEST.in

Required. Refer to Python Distutils’ Manifest template command.

Entry Scripts

Optional. Comma-separated list of entry scripts, relative to Src path

Output

Where to save obfuscated scripts and runtime files

Obfuscation Mode and Runtime Setting
Obfuscate Module Mode

How to obfuscate whole module

Obfuscate Code Mode

How to obfuscate byte code of each code object

Restrict Mode

In restrict mode, obfuscated module can NOT be imported from no obfuscated scripts.

Set Runtime Path

Set runtime path to find _pytransform.dll(.so) in target machine.

It's only used in special case. For example, use py2exe to package obfuscated scripts.

Generate project license for special user
Expired Date

Expire obfuscated scripts on some day: YYYY-MM-NN

Serial Number of Harddisk

Bind obfuscated scripts to fixed harddisk

Mac Address

Bind obfuscated scripts to mac address

IPv4 Address

Bind obfuscated scripts to ipv4 address

Registration Code

Identify string, for example, Customer-Tom

Clear
tutorial.html

You're using trail version. Free trial version that never expires, but project capsule generated is fixed by hardcode, so all the encrypted files are encrypted by same key.

A registration code is required to generate random project capsule. If PyArmor is helpful for you, please purchase one by visiting

https://shopper.mycommerce.com/checkout/cart/add/55259-1

After you have received a registration code, just replace the content of "license.lic" with registration code only (no newline).

The registration code is valid forever, it can be used permanently.

Enjoy it!

Settings

PyArmor Version

Homepage: | http://pyarmor.dashingsoft.com
Source: | https://github.com/dashingsoft/pyarmor
PyPI: | https://pypi.python.org/pypi/pyarmor
Report Issues: | https://github.com/dashingsoft/pyarmor/issues
Support Email: | jondy.zhao@gmail.com

Any question feel free to email: jondy.zhao@gmail.com

#### Projects