Releases: alphabetanetcom/python-app-bundle-shield
Python App Bundle Shield v1.3-beta.1
Python App Bundle Shield Script Documentation
Version: 1.3 GUI
© 2024 αβ.net (alphabetanet.com) - Alpha Beta Network. All Rights Reserved.
Note: This project is currently in Beta Testing and available for free.
Table of Contents
- 1. Introduction
- 2. Key Features
- 3. Main Functions of the Script
- 4. Installation
- 5. User Interface Overview
- 6. Detailed Description of Each Function
- 7. Usage Instructions
- 8. Recommendations and Best Practices
- 9. Integration with Alpha Beta Network Tools
- Appendix A: Installation of Required Packages
- Appendix B: Cross-Platform Compatibility
- Appendix C: Contact Information
1. Introduction
The Python App Bundle Shield Script is a powerful, user-friendly tool designed to help developers create standalone protected applications and executable files based on Python scripts of varying complexity. This cross-platform solution supports Python versions 3.6 and above, allowing you to package your Python code into self-contained executables for secure distribution.
Key benefits of using this script include:
- Secure Code Sharing: Utilize advanced encryption and obfuscation methods to protect your Python code during distribution.
- Source Code Protection: Prevent unauthorized access to your code with multi-level protection mechanisms.
- Seamless Application Updates: Update your applications without requiring end-users to reinstall them when using Alpha Beta Network cloud platform protection tools.
- Usage Restrictions: Implement restrictions on each instance of your application, such as expiration dates, hardware-bound licensing, usage frequency limits, and more.
- Cross-Platform Compatibility: Create applications that work on Windows, macOS, Linux/Unix, and other operating systems where Python 3.6+ is installed.
- Ease of Use: Package applications with just a few clicks using a simple graphical interface, without the need for complex configurations.
By combining the Python App Bundle Shield with other tools from the Alpha Beta Network cloud platform, developers can achieve the widest and most flexible possibilities for secure distribution of their applications.
2. Key Features
-
Unique Code Analysis Technology: Automatically analyzes and collects data about imported modules and dependencies, allowing the use of obfuscated
.py
code and compiled.pyc
files from Python version 3.6 onwards. -
Automatic Embedding of Python Environment: Embeds your complete configured Python environment with all imported modules and packages installed via
pip
into the application build. -
Additional Protection Layers: Implements code obfuscation and encryption of created executable files for enhanced security.
-
Seamless Updating of Applications: Allows updating of created applications (fixing bugs, adding functionality) without the need to reinstall them when using Alpha Beta Network cloud protection tools like the Secure Python Code Manager Script.
-
Usage Restrictions: Enables the implementation of restrictions on the use of each instance of your program (by expiration date, allowed user hardware, usage frequency, and more) when using Python scripts with Alpha Beta Network cloud protection tools (Python Obfuscator Online and Secure Python Code Manager Script), as well as local protection tools that do not require internet access (Local Python Code Protector Script and Python Binary Optimization Compiler).
-
Support for Cloud-Protected Scripts: Provides extensive capabilities to use Python scripts protected by the Alpha Beta Network cloud platform, facilitating secure code sharing and source code protection.
-
Ease of Use: Features a simple, user-friendly graphical interface that requires no complex configurations, allowing you to create secure standalone applications with minimal effort.
3. Main Functions of the Script
-
Packaging Python Scripts into Executables: Converts Python source files (
.py
) and compiled files (.pyc
) into standalone executables, making them runnable on systems without requiring Python installation. -
Embedding Full Python Runtime: Optionally embeds the entire Python runtime environment and all necessary dependencies into the executable, ensuring functionality even on systems without Python installed.
-
Code Obfuscation and Encryption: Applies multi-level protection with dynamic encryption and obfuscation techniques to enhance Python code security.
-
Integration with Cloud Protection Tools: Facilitates the use of scripts protected by Alpha Beta Network cloud platform tools, enabling seamless updates and implementation of usage restrictions.
4. Installation
Before using the Python App Bundle Shield Script, ensure that you have Python 3.6+ installed on your system.
4.1 Installing Required Packages
The script requires the following Python packages:
requests
psutil
cryptography
decompyle3
xdis
astor
pyinstaller
tkinter
(usually included with Python)
You can install them using pip
:
pip install requests psutil cryptography decompyle3 xdis astor pyinstaller
Note: For Windows users,
tkinter
may not be included by default. You may need to run the Python installer again and select the option to installtkinter
.
Ensure that you are using the correct version of pip
associated with your Python 3 installation. If you are using a virtual environment, activate it before installing the packages.
4.2 System Requirements
- Operating System: Windows, macOS, Linux/Unix, or any OS where Python 3.6+ is installed.
- Python Version: Python 3.6 or higher.
- Dependencies: As listed above.
5. User Interface Overview
The Python App Bundle Shield features a graphical user interface (GUI) with the following components:
- File Selection: Browse and select the Python file (
.py
or.pyc
) you wish to package. - Options:
- Embed Full Python Runtime: Includes the full Python environment and all installed
pip
packages in the build. Useful when your script uses additional modules or cloud-protected scripts. - Disable Console Window: Hides the console window when running the application (useful for GUI applications).
- Create a One-File Bundled Executable: Packages everything into a single executable file.
- Embed Full Python Runtime: Includes the full Python environment and all installed
- Additional Modules: Specify any additional modules (comma-separated) that need to be included.
- Progress Display: Shows the progress of the packaging process.
- Messages: Displays logs and messages during the process.
6. Detailed Description of Each Function
6.1 Packaging Python Source Files
The script packages Python source files (.py
) into standalone executables. It performs the following steps:
- Code Analysis: Automatically analyzes the code to detect imported modules and dependencies.
- Code Obfuscation: Applies multi-level obfuscation and encryption to the code.
- Dependency Inclusion: Includes necessary modules and packages in the build.
- Executable Creation: Uses PyInstaller to create the executable file.
6.2 Packaging Compiled Python Files
The script can also package compiled Python files (.pyc
), including those from Python version 3.6 onwards without available decompilers....