[Rehber] Python Scriptini EXE'ye Çevirme

Z10n · 13 Haz 2025

Sevgili THT ailesi,

Bugün sizlerle Python ile yazdığınız bir aracı, nasıl tıklanabilir bir.exedosyasına çevirebileceğinizi adım adım, sade ama teknik olarak da doğru bir şekilde paylaşmak istiyorum.
Kendi geliştirdiğim güvenlik araçlarını (örneğin XSS/SQLi Scanner veya Brute Force Tool gibi).exeolarak paylaşmak istediğimde bu yöntemi kullanıyorum. Bu rehber özellikle GUI'li (arayüzlü) araç geliştiren, konsolsuz çalışan temiz bir .exeisteyen arkadaşlar için birebirdir.

Gerekli Araç: PyInstaller
PyInstaller, Python dosyalarını.exe,.app,.bin gibi işletim sistemine özel çalıştırılabilir dosyalara dönüştürür.

Kurulum
-------------------
İlk olarak PyInstaller'ı kurmanız gerekir. Bunu terminalden ya da komut istemcisinden şu komutla yapın:

Bash:

pip install pyinstaller

Kurulum tamamlandıktan sonra artık .py dosyanızı .exe'ye çevirmeye hazırsınız demektir.

Script Dosyanızın Olduğu Klasöre Geçin
-------------------------------------------------------------------
Örneğin scriptiniz masaüstündeyse:

Bash:

cd C:\Users\KULLANICI_ADI\Desktop\aracim

cd komutu, terminalde klasör değiştirmek için kullanılır.

EXE Oluşturma Komutu
-----------------------------------------
Aşağıdakine göre giriniz:

Bash:

pyinstaller --onefile --noconsole --icon=icon.ico script.py

|Parametre Açıklamaları:|

Parametre	Açıklama
`--onefile`	Tüm dosyaları tek bir `.exe` dosyasında birleştirir.
`--noconsole`	Konsol penceresini gizler (GUI araçlar için kullanılır).
`--icon=icon.ico`	Uygulamaya simge (icon) ekler

EXE Dosyası Nerede Oluşur?
-------------------------------------------------
PyInstaller çalıştıktan sonra dist adında klasör oluşturur.
EXE dosyanız şurada bulunur:

Kod:

proje_klasörü\dist\scriptadi.exe

Artık bu dosyayı başka bilgisayarlara da atabilirsiniz.(Python kurulu olmasına gerek kalmaz.)

GUI’li Araçlar İçin Ekstra Bilgi
---------------------------------------------------
Eğer Tkinter, PyQt veya kivy gibi arayüz kütüphaneleri kullandıysanız:
---> --noconsole parametresi zorunludur, aksi halde arkada siyah bir terminal açılır.
---> Resim, ikon, yazı dosyası gibi ek kaynaklar varsa .spec dosyasına eklemeniz gerekebilir

İpuçları !
------------------
---> Eğer çok dosyalı bir proje yapıyorsanız, tüm dosyaları aynı klasörde tutup main.py gibi tek bir dosyadan çağırın.
---> EXE dosyasını paylaşmadan önce antivirüs yazılımı ile test edin, bazı av’ler exe’yi false-positive algılayabilir.
---> Eğer CLI araç yapıyorsanız --noconsole yerine --onefile kullanın.

Uyarı !!!
----------------

Bu yöntem, mevcut Python projenizi kullanıcıya daha rahat sunmak içindir.
Lütfen geliştirdiğiniz araçları izinsiz sistemlerde kullanmayın. .exe haline getirdiğiniz araçları güvenli kaynaklardan dağıtın.

Eğer bu konuda takıldığınız bir yer olursa ya da GUI’li bir tool'u nasıl paketleyeceğinizi merak ediyorsanız, yorumlara yazmanız yeterli.

HAZIRLAYAN
Z10

MehmetYukselSekeroglu · 13 Haz 2025

Eline sağlık

Z10n · 13 Haz 2025

MehmetYukselSekeroglu' Alıntı:
Eline sağlık

Sağ olasın @MehmetYukselSekeroglu

Anonimis · 13 Haz 2025

Z10n' Alıntı:
Sevgili THT ailesi,

Bugün sizlerle Python ile yazdığınız bir aracı, nasıl tıklanabilir bir.exedosyasına çevirebileceğinizi adım adım, sade ama teknik olarak da doğru bir şekilde paylaşmak istiyorum.
Kendi geliştirdiğim güvenlik araçlarını (örneğin XSS/SQLi Scanner veya Brute Force Tool gibi).exeolarak paylaşmak istediğimde bu yöntemi kullanıyorum. Bu rehber özellikle GUI'li (arayüzlü) araç geliştiren, konsolsuz çalışan temiz bir .exeisteyen arkadaşlar için birebirdir.

Gerekli Araç: PyInstaller
PyInstaller, Python dosyalarını.exe,.app,.bin gibi işletim sistemine özel çalıştırılabilir dosyalara dönüştürür.

Kurulum
-------------------
İlk olarak PyInstaller'ı kurmanız gerekir. Bunu terminalden ya da komut istemcisinden şu komutla yapın:

Bash:

pip install pyinstaller

Kurulum tamamlandıktan sonra artık .py dosyanızı .exe'ye çevirmeye hazırsınız demektir.

Script Dosyanızın Olduğu Klasöre Geçin
-------------------------------------------------------------------
Örneğin scriptiniz masaüstündeyse:

Bash:

cd C:\Users\KULLANICI_ADI\Desktop\aracim

EXE Oluşturma Komutu
-----------------------------------------
Aşağıdakine göre giriniz:

Bash:

pyinstaller --onefile --noconsole --icon=icon.ico script.py

|Parametre Açıklamaları:|

Parametre Açıklama
--onefile Tüm dosyaları tek bir .exe dosyasında birleştirir.
--noconsole Konsol penceresini gizler (GUI araçlar için kullanılır).
--icon=icon.ico Uygulamaya simge (icon) ekler

EXE Dosyası Nerede Oluşur?
-------------------------------------------------
PyInstaller çalıştıktan sonra dist adında klasör oluşturur.
EXE dosyanız şurada bulunur:

Kod:

proje_klasörü\dist\scriptadi.exe

Artık bu dosyayı başka bilgisayarlara da atabilirsiniz.(Python kurulu olmasına gerek kalmaz.)

GUI’li Araçlar İçin Ekstra Bilgi
---------------------------------------------------
Eğer Tkinter, PyQt veya kivy gibi arayüz kütüphaneleri kullandıysanız:
---> --noconsole parametresi zorunludur, aksi halde arkada siyah bir terminal açılır.
---> Resim, ikon, yazı dosyası gibi ek kaynaklar varsa .spec dosyasına eklemeniz gerekebilir

İpuçları !
------------------
---> Eğer çok dosyalı bir proje yapıyorsanız, tüm dosyaları aynı klasörde tutup main.py gibi tek bir dosyadan çağırın.
---> EXE dosyasını paylaşmadan önce antivirüs yazılımı ile test edin, bazı av’ler exe’yi false-positive algılayabilir.
---> Eğer CLI araç yapıyorsanız --noconsole yerine --onefile kullanın.

Uyarı !!!
----------------

Eğer bu konuda takıldığınız bir yer olursa ya da GUI’li bir tool'u nasıl paketleyeceğinizi merak ediyorsanız, yorumlara yazmanız yeterli.

HAZIRLAYAN
Z10

Konu güzel geliştirilebilir eline sağlık.

Z10n · 13 Haz 2025

Anonimis' Alıntı:
Konu güzel geliştirilebilir eline sağlık.

Sağ olasın @Anonimis başkan

Maveraün Nehr · 13 Haz 2025

Bence buna ek bir de benim merak ettiğim bu pyinstaller içerisinde ne gibi fonksiyonlar var? Yani organları nelerden oluşur? Bunu merak ediyorum

Kurt_44 · 13 Haz 2025

Z10n' Alıntı:
Sevgili THT ailesi,

Bugün sizlerle Python ile yazdığınız bir aracı, nasıl tıklanabilir bir.exedosyasına çevirebileceğinizi adım adım, sade ama teknik olarak da doğru bir şekilde paylaşmak istiyorum.
Kendi geliştirdiğim güvenlik araçlarını (örneğin XSS/SQLi Scanner veya Brute Force Tool gibi).exeolarak paylaşmak istediğimde bu yöntemi kullanıyorum. Bu rehber özellikle GUI'li (arayüzlü) araç geliştiren, konsolsuz çalışan temiz bir .exeisteyen arkadaşlar için birebirdir.

Gerekli Araç: PyInstaller
PyInstaller, Python dosyalarını.exe,.app,.bin gibi işletim sistemine özel çalıştırılabilir dosyalara dönüştürür.

Kurulum
-------------------
İlk olarak PyInstaller'ı kurmanız gerekir. Bunu terminalden ya da komut istemcisinden şu komutla yapın:

Bash:

pip install pyinstaller

Kurulum tamamlandıktan sonra artık .py dosyanızı .exe'ye çevirmeye hazırsınız demektir.

Script Dosyanızın Olduğu Klasöre Geçin
-------------------------------------------------------------------
Örneğin scriptiniz masaüstündeyse:

Bash:

cd C:\Users\KULLANICI_ADI\Desktop\aracim

EXE Oluşturma Komutu
-----------------------------------------
Aşağıdakine göre giriniz:

Bash:

pyinstaller --onefile --noconsole --icon=icon.ico script.py

|Parametre Açıklamaları:|

Parametre Açıklama
--onefile Tüm dosyaları tek bir .exe dosyasında birleştirir.
--noconsole Konsol penceresini gizler (GUI araçlar için kullanılır).
--icon=icon.ico Uygulamaya simge (icon) ekler

EXE Dosyası Nerede Oluşur?
-------------------------------------------------
PyInstaller çalıştıktan sonra dist adında klasör oluşturur.
EXE dosyanız şurada bulunur:

Kod:

proje_klasörü\dist\scriptadi.exe

Artık bu dosyayı başka bilgisayarlara da atabilirsiniz.(Python kurulu olmasına gerek kalmaz.)

GUI’li Araçlar İçin Ekstra Bilgi
---------------------------------------------------
Eğer Tkinter, PyQt veya kivy gibi arayüz kütüphaneleri kullandıysanız:
---> --noconsole parametresi zorunludur, aksi halde arkada siyah bir terminal açılır.
---> Resim, ikon, yazı dosyası gibi ek kaynaklar varsa .spec dosyasına eklemeniz gerekebilir

İpuçları !
------------------
---> Eğer çok dosyalı bir proje yapıyorsanız, tüm dosyaları aynı klasörde tutup main.py gibi tek bir dosyadan çağırın.
---> EXE dosyasını paylaşmadan önce antivirüs yazılımı ile test edin, bazı av’ler exe’yi false-positive algılayabilir.
---> Eğer CLI araç yapıyorsanız --noconsole yerine --onefile kullanın.

Uyarı !!!
----------------

Eğer bu konuda takıldığınız bir yer olursa ya da GUI’li bir tool'u nasıl paketleyeceğinizi merak ediyorsanız, yorumlara yazmanız yeterli.

HAZIRLAYAN
Z10

Elinize sağlık

Z10n · 13 Haz 2025

PyInstaller, Python ile yazılmış bir script’i çalıştırılabilir .exe dosyasına dönüştüren güçlü bir araçtır. Bu işlem dört temel aşamadan oluşur: İlk olarak Analysis aşamasında, script içindeki tüm bağımlılıklar (modüller, dosyalar, importlar) taranır ve hook sistemi ile özel modüller tanınır. Ardından Building aşamasında bu içerikler derlenir, .pyc (bytecode) formatına çevrilir ve PYZ, PKG, EXE gibi yapılar oluşturularak düzenlenir. Üçüncü aşama olan Bootloader, çalıştırılabilir dosyanın C diliyle yazılmış kalbidir; EXE açıldığında önce bu küçük program devreye girerek Python ortamını hazırlar ve ana uygulamayı başlatır. Son olarak Packaging aşamasında tüm bu dosyalar ya tek bir .exe dosyasında (--onefile) ya da çoklu klasör yapısında (--onedir) paketlenir. PyInstaller'ın bu yapısı sayesinde yazdığınız Python programı, hedef sistemde Python kurulu olmasa bile bağımsız çalışabilir. Ayrıca .spec dosyası ile ikon ekleme, ekstra veri gömme, gizli import tanımlama gibi özelleştirmeler de mümkündür. Kısacası PyInstaller sadece bir dönüştürücü değil, içinde mini bir derleyici, dosya paketleyici ve başlatıcı barındıran gelişmiş bir yapıdır.

inşallah yararlı olmuştur

Z10n · 13 Haz 2025

Maveraün Nehr' Alıntı:
Bence buna ek bir de benim merak ettiğim bu pyinstaller içerisinde ne gibi fonksiyonlar var? Yani organları nelerden oluşur? Bunu merak ediyorum

PyInstaller, Python ile yazılmış bir script’i çalıştırılabilir .exe dosyasına dönüştüren güçlü bir araçtır. Bu işlem dört temel aşamadan oluşur: İlk olarak Analysis aşamasında, script içindeki tüm bağımlılıklar (modüller, dosyalar, importlar) taranır ve hook sistemi ile özel modüller tanınır. Ardından Building aşamasında bu içerikler derlenir, .pyc (bytecode) formatına çevrilir ve PYZ, PKG, EXE gibi yapılar oluşturularak düzenlenir. Üçüncü aşama olan Bootloader, çalıştırılabilir dosyanın C diliyle yazılmış kalbidir; EXE açıldığında önce bu küçük program devreye girerek Python ortamını hazırlar ve ana uygulamayı başlatır. Son olarak Packaging aşamasında tüm bu dosyalar ya tek bir .exe dosyasında (--onefile) ya da çoklu klasör yapısında (--onedir) paketlenir. PyInstaller'ın bu yapısı sayesinde yazdığınız Python programı, hedef sistemde Python kurulu olmasa bile bağımsız çalışabilir. Ayrıca .spec dosyası ile ikon ekleme, ekstra veri gömme, gizli import tanımlama gibi özelleştirmeler de mümkündür. Kısacası PyInstaller sadece bir dönüştürücü değil, içinde mini bir derleyici, dosya paketleyici ve başlatıcı barındıran gelişmiş bir yapıdır.

inşallah yararlı olmuştur

sametghack · 13 Haz 2025

Elinize saglik

Z10n · 13 Haz 2025

sametghack68' Alıntı:
Elinize saglik

Sağ olasın Dostum

Maveraün Nehr · 13 Haz 2025

Z10n' Alıntı:
PyInstaller, Python ile yazılmış bir script’i çalıştırılabilir .exe dosyasına dönüştüren güçlü bir araçtır. Bu işlem dört temel aşamadan oluşur: İlk olarak Analysis aşamasında, script içindeki tüm bağımlılıklar (modüller, dosyalar, importlar) taranır ve hook sistemi ile özel modüller tanınır. Ardından Building aşamasında bu içerikler derlenir, .pyc (bytecode) formatına çevrilir ve PYZ, PKG, EXE gibi yapılar oluşturularak düzenlenir. Üçüncü aşama olan Bootloader, çalıştırılabilir dosyanın C diliyle yazılmış kalbidir; EXE açıldığında önce bu küçük program devreye girerek Python ortamını hazırlar ve ana uygulamayı başlatır. Son olarak Packaging aşamasında tüm bu dosyalar ya tek bir .exe dosyasında (--onefile) ya da çoklu klasör yapısında (--onedir) paketlenir. PyInstaller'ın bu yapısı sayesinde yazdığınız Python programı, hedef sistemde Python kurulu olmasa bile bağımsız çalışabilir. Ayrıca .spec dosyası ile ikon ekleme, ekstra veri gömme, gizli import tanımlama gibi özelleştirmeler de mümkündür. Kısacası PyInstaller sadece bir dönüştürücü değil, içinde mini bir derleyici, dosya paketleyici ve başlatıcı barındıran gelişmiş bir yapıdır.

inşallah yararlı olmuştur

Bu hafta ben de bir makale yazayım bari

Z10n · 13 Haz 2025

Ben detaylı anlatmaya çalışıyorum ki tam anlaşılsın ama sana da tavsiye ederim xD

haz3root · 13 Haz 2025

Z10n' Alıntı:
Sevgili THT ailesi,

Bugün sizlerle Python ile yazdığınız bir aracı, nasıl tıklanabilir bir.exedosyasına çevirebileceğinizi adım adım, sade ama teknik olarak da doğru bir şekilde paylaşmak istiyorum.
Kendi geliştirdiğim güvenlik araçlarını (örneğin XSS/SQLi Scanner veya Brute Force Tool gibi).exeolarak paylaşmak istediğimde bu yöntemi kullanıyorum. Bu rehber özellikle GUI'li (arayüzlü) araç geliştiren, konsolsuz çalışan temiz bir .exeisteyen arkadaşlar için birebirdir.

Gerekli Araç: PyInstaller
PyInstaller, Python dosyalarını.exe,.app,.bin gibi işletim sistemine özel çalıştırılabilir dosyalara dönüştürür.

Kurulum
-------------------
İlk olarak PyInstaller'ı kurmanız gerekir. Bunu terminalden ya da komut istemcisinden şu komutla yapın:

Bash:

pip install pyinstaller

Kurulum tamamlandıktan sonra artık .py dosyanızı .exe'ye çevirmeye hazırsınız demektir.

Script Dosyanızın Olduğu Klasöre Geçin
-------------------------------------------------------------------
Örneğin scriptiniz masaüstündeyse:

Bash:

cd C:\Users\KULLANICI_ADI\Desktop\aracim

EXE Oluşturma Komutu
-----------------------------------------
Aşağıdakine göre giriniz:

Bash:

pyinstaller --onefile --noconsole --icon=icon.ico script.py

|Parametre Açıklamaları:|

Parametre Açıklama
--onefile Tüm dosyaları tek bir .exe dosyasında birleştirir.
--noconsole Konsol penceresini gizler (GUI araçlar için kullanılır).
--icon=icon.ico Uygulamaya simge (icon) ekler

EXE Dosyası Nerede Oluşur?
-------------------------------------------------
PyInstaller çalıştıktan sonra dist adında klasör oluşturur.
EXE dosyanız şurada bulunur:

Kod:

proje_klasörü\dist\scriptadi.exe

Artık bu dosyayı başka bilgisayarlara da atabilirsiniz.(Python kurulu olmasına gerek kalmaz.)

GUI’li Araçlar İçin Ekstra Bilgi
---------------------------------------------------
Eğer Tkinter, PyQt veya kivy gibi arayüz kütüphaneleri kullandıysanız:
---> --noconsole parametresi zorunludur, aksi halde arkada siyah bir terminal açılır.
---> Resim, ikon, yazı dosyası gibi ek kaynaklar varsa .spec dosyasına eklemeniz gerekebilir

İpuçları !
------------------
---> Eğer çok dosyalı bir proje yapıyorsanız, tüm dosyaları aynı klasörde tutup main.py gibi tek bir dosyadan çağırın.
---> EXE dosyasını paylaşmadan önce antivirüs yazılımı ile test edin, bazı av’ler exe’yi false-positive algılayabilir.
---> Eğer CLI araç yapıyorsanız --noconsole yerine --onefile kullanın.

Uyarı !!!
----------------

Eğer bu konuda takıldığınız bir yer olursa ya da GUI’li bir tool'u nasıl paketleyeceğinizi merak ediyorsanız, yorumlara yazmanız yeterli.

HAZIRLAYAN
Z10

Güzel olmuş.

Z10n · 13 Haz 2025

haz3root' Alıntı:
Güzel olmuş.

Sağ olasın Dostum @haz3root

Maveraün Nehr · 13 Haz 2025

Z10n' Alıntı:
Ben detaylı anlatmaya çalışıyorum ki tam anlaşılsın ama sana da tavsiye ederim xD

haz3root · 13 Haz 2025

Maveraün Nehr' Alıntı:

Z10n · 13 Haz 2025

Sen yaz bakalım nasıl olacak

Maveraün Nehr · 13 Haz 2025

Z10n' Alıntı:
Sen yaz bakalım nasıl olacak

Yagami Light0 · 13 Haz 2025

Elinize saglik , scriptin icindeki kutuphaneleri indirmek gerekliyse onceden hidden import yapilmali , aksi halde exe ye cevirip baska bilgisayarda calisdirirsaniz kutuphanelerden dolayi sorun yasayacaksiniz .

[Rehber] Python Scriptini EXE'ye Çevirme

Üye

Üye

Üye

Katılımcı Üye

Üye

Anka Team

Editör

Üye

Üye

Moderatör

Üye

Anka Team

Üye

Katılımcı Üye

Üye

Anka Team

Katılımcı Üye

Üye

Anka Team

Katılımcı Üye