- Katılım
- 25 Tem 2026
- Mesajlar
- 1,575
- Beğeniler
- 234
- Yaş
- 15
- İletişim



PyInstaller Extractor & Python Bytecode Decompiler
Merhaba! Geliştirdiğim Python EXE analiz ve kaynak kod çıkarma projesini paylaşmak istiyorum.
Bu araç, PyInstaller kullanılarak paketlenmiş Python EXE dosyalarını analiz etmek, içerisindeki dosyaları çıkarmak ve uygun Python bytecode dosyalarını kaynak koda dönüştürmeyi denemek amacıyla geliştirilmiştir.
Amacım farklı analiz, dosya çıkarma ve decompiler araçlarını tek bir terminal arayüzünde birleştirerek kullanımı daha kolay ve düzenli hâle getirmek.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
İNDİRME LİNKİ :
Linkleri görebilmek için kayıt olmanız gerekmektedir
VİRUSTOTAL : Py Dosyası Zaten
FOTOĞRAF :
Linkleri görebilmek için kayıt olmanız gerekmektedir
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. PROGRAMIN ÖZELLİKLERİ
PyInstaller EXE Analizi
- PyInstaller ile paketlenmiş EXE dosyalarını analiz eder.
- Uygulamanın arşiv yapısını inceler.
- Paket içerisindeki çıkarılabilir dosyaları bulur.
- Dosyaların dışarı aktarılmasına yardımcı olur.
Python Dosyası Çıkarma
Desteklenen ve bulunan dosyaları türlerine göre ayırmayı hedefler:- .py
- .pyc
- .pyo
- .pyd
- .dll
- .json
- .dat
- .ini
- .cfg
Python Bytecode Decompiler
- Uygun .pyc ve .pyo dosyalarını analiz eder.
- Python bytecode sürümünü dikkate alır.
- Desteklenen dosyalarda kaynak kod üretmeyi dener.
- Başarıyla dönüştürülen dosyaları .py biçiminde kaydeder.
- Dönüştürülemeyen dosyaları ayrı şekilde muhafaza eder.
Düzenli Çıktı Sistemi
İşlem sonunda dosyalar tek bir klasöre karmaşık şekilde bırakılmaz. Dosyalar türlerine ve kullanım amaçlarına göre sınıflandırılır.━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2. GEREKLİ PROGRAMLAR VE KÜTÜPHANELER
Aracın çalışabilmesi için çeşitli Python kütüphaneleri ve yardımcı yazılım araçları kullanılmaktadır.
Python 3.15 x64
Online kurulum dosyasının ana Python ortamı olarak kullanılır.Python, programın temel çalışma ortamıdır.
İndirme:
Linkleri görebilmek için kayıt olmanız gerekmektedir
Kurulum sırasında Python Launcher (py) seçeneğinin etkin olduğundan emin olun.
pyinstxtractor-ng
PyInstaller arşivlerini açmak ve paket içerisindeki dosyaları çıkarmak için kullanılır.EXE analiz sürecinin temel bileşenlerinden biridir.
xdis
Python bytecode dosyalarının farklı Python sürümlerine göre analiz edilmesine yardımcı olur.Özellikle farklı Python sürümleriyle oluşturulmuş .pyc dosyalarının incelenmesinde kullanılır.
Rich
Terminal arayüzünün daha düzenli ve görsel hâle getirilmesini sağlar.Kullanım alanları:
- Renkli terminal yazıları
- Menü tabloları
- Bilgilendirme panelleri
- İşlem sonuçları
- Uyarılar ve hata mesajları
PyLingual
Projenin kaynak koda dönüştürme aşamasında kullandığı temel decompiler araçlarından biridir.Uygun Python bytecode dosyalarını analiz ederek kaynak kod üretmeyi dener.
PyLingual'ın makine öğrenmesi bağımlılıkları ve model dosyaları bulunduğundan ilk kurulum ve ilk kullanım uzun sürebilir.
GitHub:
Linkleri görebilmek için kayıt olmanız gerekmektedir
UV
Python araçlarının ve ayrı Python çalışma ortamlarının yönetilmesini sağlar.Kurulum sisteminde PyLingual için ayrı bir Python 3.14 çalışma ortamı hazırlanır. Böylece ana programın Python sürümüyle decompiler ortamı birbirinden ayrılır.
Git for Windows
PyLingual ve xdis kaynak kodlarının GitHub üzerinden indirilmesi ve hazırlanması için gereklidir.İndirme:
Linkleri görebilmek için kayıt olmanız gerekmektedir
Diğer bileşenler
- PyInstaller: Windows EXE paketleme ve derleme işlemlerinde kullanılan araç.
- PyCryptodome: Gerekli olduğu durumlarda kullanılan kriptografik bağımlılık.
- Tkinter: Windows dosya seçme penceresini açmak için kullanılan Python bileşeni.
3. KURULUM
Proje için ayrıca online kurulum paketi hazırlanmıştır.
Gerekenler
- Windows 10 veya Windows 11 (64-bit)
- Python 3.15 x64
- Git for Windows
- İnternet bağlantısı
- Yeterli disk alanı
Kurulum adımları
- Python kontrolü
- Git kontrolü
- Pip güncellemesi
- Gerekli Python bağımlılıklarının kurulması
- UV kurulumu
- PyLingual kaynaklarının indirilmesi
- xdis kaynaklarının hazırlanması
- PyLingual bağımlılıklarının ayarlanması
- Python 3.14 çalışma ortamının hazırlanması
- PyLingual kurulumu
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4. NASIL KULLANILIR?
Program açıldığında terminal üzerinden işlem menüsü karşılar.Üç temel işlem seçeneği bulunmaktadır:
SEÇENEK 1 – HAM DOSYALARI ÇIKAR
Bu seçenek seçilen EXE dosyasının içerisindeki çıkarılabilir dosyaları ayıklamaya odaklanır.Kullanım:
- Menüden 1 tuşuna basın.
- Windows dosya seçme penceresinden analiz etmek istediğiniz EXE dosyasını seçin.
- Programın arşiv analizini tamamlamasını bekleyin.
- Çıkarılan dosyaları oluşturulan sonuç klasöründen inceleyin.
SEÇENEK 2 – DECOMPILE EDİLMİŞ KAYNAĞI ÇIKAR
Bu seçenek, dosya çıkarma işleminin yanında uygun Python bytecode dosyalarını kaynak koda dönüştürmeyi de dener.Kullanım:
- Menüden 2 tuşuna basın.
- Analiz edilecek EXE dosyasını seçin.
- Program çıkarılan bytecode dosyalarını inceler.
- PyLingual üzerinden uygun dosyalar için dönüşüm işlemi gerçekleştirilir.
- Başarılı dönüşümler .py olarak kaydedilir.
- Dönüştürülemeyen dosyalar ayrıca korunur.
SEÇENEK 3 – DIRECT SOURCE CODE
Bu seçenek, kaynak kod elde etmeyi hedefleyen kapsamlı işlem modudur.Dosya çıkarma ve decompile işlemlerini bir araya getirir.
Başarılı dönüşümler DIRECT_SOURCE_CODE/python_source klasöründe toplanır.
Bu seçenek özellikle çıkarılan dosyaları daha düzenli bir yapı içerisinde incelemek isteyenler için hazırlanmıştır.
SEÇENEK 0 – ÇIKIŞ
Programı kapatır.━━━━━━━━━━━━━━━━━━━━━━━━━━━━
5. ÇIKTI KLASÖRLERİ
Analiz işlemi tamamlandığında EXE dosyasının adına göre ayrı bir çıktı klasörü oluşturulur.Genel klasör yapısı:
EXE_ADI_OUTPUT/
│
├── extracted_archive/
│
├── source_files/
│
├── resources/
│
├── dependencies/
│
├── native_modules/
│
├── review_required/
│
├── decompiled/
│
├── not_decompiled/
│
├── DIRECT_SOURCE_CODE/
│ └── python_source/
│
└── reports/
├── recovery_report.txt
└── recovery_report.json
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
6. SIK KARŞILAŞILAN SORUNLAR
Python bulunamadı hatası
Python 3.15 x64 kurulumunu kontrol edin.PowerShell üzerinden:
py -3.15 --version
Git bulunamadı hatası
Git for Windows kurulumunu kontrol edin:git --version
PyLingual bulunamadı
Online kurulumun tamamlandığından emin olun. Gerekli bağlantıların ve bağımlılıkların kurulması gerekir.
İlk decompile işlemi uzun sürüyor
PyLingual modellerinin ilk defa indirilmesi ve yüklenmesi zaman alabilir. İnternet bağlantınızı ve boş disk alanınızı kontrol edin.
Bazı dosyalar kaynak koda dönüştürülemiyor
Her Python bytecode sürümü aynı şekilde desteklenmez. Ayrıca .pyd ve .dll gibi derlenmiş yerel modüller normal .pyc dosyaları gibi Python kaynak koduna dönüştürülemez.
Kaynak kod eksik görünüyor
Decompile işlemi orijinal kaynak kodun birebir aynısını garanti etmez. Değişken isimleri, yorumlar ve biçimlendirme kaybolabilir.━━━━━━━━━━━━━━━━━━━━━━━━━━━━
7. ÖNEMLİ TEKNİK NOTLAR
- Araç PyInstaller ile paketlenmiş EXE dosyalarını hedefler.
- Seçilen EXE dosyasını çalıştırmak yerine arşiv olarak incelemeye çalışır.
- Her EXE dosyasının içerisindeki bütün kodların çıkarılması garanti değildir.
- PYC/PYO dosyalarının dönüştürülmesi Python bytecode sürümüne bağlıdır.
- Native modüller normal Python decompiler araçlarıyla doğrudan .py dosyasına dönüştürülemez.
- Dönüştürülemeyen dosyalar mümkün olduğunca ham hâlleriyle korunur.
- Araç yalnızca analiz etme yetkiniz bulunan uygulamalarda kullanılmalıdır.
8. GELİŞTİRME VE GERİ BİLDİRİM
Bu projeyi geliştirirken amacım PyInstaller EXE analizi, dosya çıkarma ve Python bytecode dönüşüm işlemlerini tek bir terminal arayüzünde toplamaktı.Farklı araçları tek bir yerde buluşturmak ve kullanıcıların analiz işlemlerini daha düzenli gerçekleştirebilmesini sağlamak istedim.
Hata raporları, uyumluluk sorunları ve geliştirme önerileri benim için değerlidir.
Teşekkürler!