11# Python EXE Builder
22
3+ [ English] ( #english ) | [ 日本語] ( #japanese )
4+
5+ <a id =" english " ></a >
6+ ## Python EXE Builder
7+
38A tool that converts Python scripts to Windows executable files (.exe) with simple operations.
49
5- ## Features
10+ ### Features
611
712- ** Easy Operation** : Convert Python scripts to .exe files just by following guided prompts
813- ** Automatic Environment Setup** : Automatically sets up a Python virtual environment
@@ -13,15 +18,15 @@ A tool that converts Python scripts to Windows executable files (.exe) with simp
1318 - Hidden console window
1419- ** PyInstaller Utilization** : Uses reliable PyInstaller for conversion
1520
16- ## Requirements
21+ ### Requirements
1722
1823- Windows OS
1924- Python 3.6 or higher
2025
21- ## Usage
26+ ### Usage
2227
23281 . Clone this repository or download as ZIP
24- 2 . Double-click ` python-exe-builder .bat ` to run
29+ 2 . Double-click ` python-exe-builder_en .bat ` (English) or ` python-exe-builder_ja.bat ` (Japanese) to run
25303 . Follow the on-screen instructions to enter information:
2631 - Project name (name of the output executable file)
2732 - Path of the Python file to convert
@@ -36,20 +41,20 @@ To use a custom icon:
36412 . Place it in the same directory as the batch file
37423 . Select "y" at the "Do you want to change the icon?" prompt during conversion
3843
39- ## Output Results
44+ ### Output Results
4045
4146After conversion, the executable file will be generated in the following location:
4247
4348- ** For single file format** : ` [Project name]/dist/[Project name].exe `
4449- ** For folder format** : ` [Project name]/dist/[Project name]/[Project name].exe `
4550
46- ## Notes
51+ ### Notes
4752
4853- Single file format: Can be distributed with just a single .exe file
4954- Folder format: Need to distribute the entire generated folder (larger size but faster startup)
5055- A properly functioning executable file will be generated by accurately specifying all dependencies
5156
52- ## Identifying Dependencies
57+ ### Identifying Dependencies
5358
5459This tool cannot automatically detect necessary libraries. You need to identify the dependent libraries used by your Python script in advance.
5560
@@ -64,10 +69,87 @@ Recommended tools for identifying dependencies:
64693 . ** dependency-extractor** : A tool for extracting dependent libraries from Python scripts
6570 - https://github.com/calico-blanket/dependency-extractor
6671
67- ## License
72+ ### License
6873
6974MIT
7075
71- ## Contribution
76+ ### Contribution
7277
7378Contributions are welcome! We look forward to issue reports and pull requests for improvement.
79+
80+ ---
81+
82+ <a id =" japanese " ></a >
83+ ## Python EXE Builder
84+
85+ シンプルな操作でPythonスクリプトをWindowsの実行ファイル(.exe)に変換するツールです。
86+
87+ ### 特徴
88+
89+ - ** 簡単操作** : ガイド付きのプロンプトに従うだけで、Pythonスクリプトを.exeファイルに変換
90+ - ** 自動環境構築** : Python仮想環境を自動的にセットアップ
91+ - ** 依存関係の管理** : 指定したライブラリを仮想環境内に自動インストール(※ライブラリの特定は手動で行う必要があります)
92+ - ** カスタマイズオプション** :
93+ - アイコンの変更
94+ - ワンファイル形式/フォルダ形式の選択
95+ - コンソールウィンドウ非表示
96+ - ** PyInstaller活用** : 信頼性の高いPyInstallerを使用
97+
98+ ### 必要要件
99+
100+ - Windows OS
101+ - Python 3.6以上
102+
103+ ### 使い方
104+
105+ 1 . このリポジトリをクローンまたはZIPでダウンロード
106+ 2 . ` python-exe-builder_ja.bat ` (日本語)または` python-exe-builder_en.bat ` (英語)をダブルクリックで実行
107+ 3 . 画面の指示に従って情報を入力:
108+ - プロジェクト名(出力される実行ファイルの名前)
109+ - 変換するPythonファイルのパス
110+ - 必要な追加ライブラリ(スペース区切り)
111+ - アイコン変更の有無
112+ - 出力形式(単一ファイル or フォルダ構造)
113+
114+ ### アイコンのカスタマイズ
115+
116+ カスタムアイコンを使用するには:
117+ 1 . 使用したいアイコンファイルを「icon.ico」という名前に変更
118+ 2 . バッチファイルと同じディレクトリに配置
119+ 3 . 変換時に「アイコンを変更しますか?」のプロンプトで「y」を選択
120+
121+ ### 出力結果
122+
123+ 変換が完了すると、以下の場所に実行ファイルが生成されます:
124+
125+ - ** 単一ファイル形式の場合** : ` [プロジェクト名]/dist/[プロジェクト名].exe `
126+ - ** フォルダ形式の場合** : ` [プロジェクト名]/dist/[プロジェクト名]/[プロジェクト名].exe `
127+
128+ ### 注意事項
129+
130+ - 単一ファイル形式:単一の.exeファイルのみで配布可能
131+ - フォルダ形式:生成されたフォルダ全体を配布する必要あり(サイズは大きいが起動が速い)
132+ - 全ての依存関係を正確に指定することで、正常に動作する実行ファイルが生成されます
133+
134+ ### 依存関係の特定方法
135+
136+ このツールは必要なライブラリを自動検出することはできません。Pythonスクリプトが使用する依存ライブラリを事前に特定しておく必要があります。
137+
138+ 依存関係を特定するための方法:
139+
140+ 1 . ** pipreqs** : プロジェクトから依存関係を抽出
141+ - https://github.com/bndr/pipreqs
142+
143+ 2 . ** pip-tools** : 依存関係を管理するツール
144+ - https://github.com/jazzband/pip-tools
145+
146+ 3 . ** dependency-extractor** : Pythonスクリプトから依存ライブラリを抽出するツール
147+ - https://github.com/calico-blanket/dependency-extractor
148+
149+ ### ライセンス
150+
151+ MIT
152+
153+ ### 貢献
154+
155+ 貢献は歓迎します!Issue報告や改善のためのプルリクエストをお待ちしています。
0 commit comments