Linux Resim Editörü

Bu proje, Linux ortamında sıkça kullanılan ImageMagick aracı için geliştirilmiş, hem grafiksel (GUI) hem de terminal tabanlı (TUI) kullanıcı arayüzü sağlayan bir Shell Script uygulamasıdır.

2025-2026 Güz Dönemi Linux Araçları ve Kabuk Programlama Dersi kapsamında geliştirilmiştir.

📋 İçindekiler

• Projenin Amacı
• Özellikler
• Kullanılan Teknolojiler
• Kurulum ve Gereksinimler
• Kullanım
• Proje Yapısı
• Tanıtım Videosu
• Ekran Görüntüleri
• Geliştirme Fikirleri
• Sorun Giderme

🎯 Projenin Amacı

Karmaşık terminal komutlarını ezberlemeye gerek kalmadan; resim dönüştürme, boyutlandırma, efekt uygulama ve filigran ekleme gibi işlemleri kullanıcı dostu bir arayüz ile gerçekleştirmeyi sağlar. Yerli işletim sistemimiz Pardus üzerinde de uyumlu çalışır.

🚀 Özellikler

Uygulama iki farklı modda çalışabilir:

1. GUI Modu (YAD): Modern pencereler, dosya seçiciler ve görsel ilerleme çubukları içerir.
2. TUI Modu (Whiptail): Sadece klavye ile yönetilebilen, kaynak dostu terminal arayüzüdür.

Yapılabilen İşlemler:

• Format Dönüştürme: JPG, PNG, PDF, WEBP formatları arasında dönüşüm.
• Boyutlandırma: Yüzdesel (%50) veya piksel bazlı (800x600) boyutlandırma.
• Döndürme: Sağa, sola veya ters çevirme işlemleri.
• Efektler: Siyah-Beyaz, Sepya, Negatif ve Bulanıklaştırma filtreleri.
• Toplu İşlem: Bir klasördeki tüm resimleri tek seferde dönüştürme.
• Filigran: Resimlerin üzerine yazı ekleme (Konum seçenekli).
• Çerçeve Ekleme: İstenilen renk ve kalınlıkta çerçeve ekleme.
• Bilgi Alma: Resim çözünürlüğü, boyutu ve format bilgilerini görüntüleme.

İşlem Kaydı (Loglama): Yapılan işlemler tarih ve saat bilgisiyle operation_log.txt dosyasına kaydedilir.

🧠 Kullanılan Teknolojiler

• Bash (Shell Script): Ana programlama dili

• ImageMagick: Resim işleme (convert, identify)

• YAD: Grafiksel kullanıcı arayüzü (GUI)

• Whiptail: Terminal tabanlı arayüz (TUI)

• Linux / Pardus: Hedef işletim sistemi

🛠️ Kurulum ve Gereksinimler

Proje Pardus ve Debian tabanlı sistemlerde çalışmak üzere tasarlanmıştır.

1. Projeyi İndirin

git clone https://github.com/sdnrelms/linux-image-editor.git
cd linux-image-editor

2. Çalıştırma İzinlerini Verin

Script dosyalarının çalışabilmesi için yetki vermeniz gerekir:

chmod +x main.sh
chmod +x lib/*.sh

3. Bağımlılıklar

Program ilk çalıştığında eksik paketleri otomatik kontrol eder. Elle kurmak isterseniz:

sudo apt update
sudo apt install imagemagick yad whiptail

Kolay Kurulum (Masaüstü Kısayolu)

Her seferinde terminale girmek zorunda kalmadan uygulamayı kullanmak isterseniz, uygulamayı masaüstü ortamına entegre eden install.sh dosyası mevcuttur.

Uygulamayı sistem menüsüne eklemek için:

chmod +x install.sh
./install.sh

Kurulumdan sonra uygulama menüsünden "Linux Resim Editörü" yazarak başlatabilirsiniz.

Kaldırma (Uninstall)

Eğer uygulama menüsünden kaldırmak isterseniz:

rm ~/.local/share/applications/linux-image-editor.desktop
update-desktop-database ~/.local/share/applications 2>/dev/null

💻 Kullanım

Programı çalıştırmak için terminali açın ve proje dizinine gelin.

Grafik Arayüz (GUI) ile Başlatma (Varsayılan):

./main.sh
# veya
./main.sh --gui

Terminal Arayüzü (TUI) ile Başlatma:

./main.sh --tui

Yardım Menüsü:

./main.sh --help

📂 Proje Yapısı

linux-image-editor/
├── main.sh                 # Ana çalıştırılabilir dosya
├── install.sh              # Uygulamayı sistem menüsüne ekleme
├── icon.png                # Uygulama için kullanılan simge dosyası
├── README.md               # Proje dökümantasyonu
├── screenshot/             # Proje ekran görüntüleri
└── lib/                    # Kütüphane dosyaları
    ├── image_ops.sh        # ImageMagick fonksiyonları 
    ├── gui_functions.sh    # YAD arayüz fonksiyonları
    └── tui_functions.sh    # Whiptail arayüz fonksiyonları

Not: Uygulama çalıştırıldığında operation_log.txt dosyası otomatik olarak oluşturulur.

🎥 Tanıtım Videosu

Projenin kurulumu ve kullanımını anlatan videoya aşağıdaki linkten ulaşabilirsiniz:

Link

📸 Ekran Görüntüleri

GUI Modu (YAD)

TUI Modu (Whiptail)

Kullanım Örneği:

Uygulama ana ekranı:

Efekt seçim menüsü:

Uygulama başarılı mesajı:

Dönüştürülmüş görsel:

📈 Geliştirme Fikirleri

• Daha fazla efekt ve filtre

• Geri alma (Undo) desteği

❓ Sorun Giderme (Troubleshooting)

• "İzin reddedildi" (Permission denied) hatası alıyorum.

  • Cevap: chmod +x main.sh komutunu çalıştırdığınızdan emin olun.

• Resimler dönüşmüyor, hata veriyor.

  • Cevap: Dosya adında Türkçe karakter veya boşluk varsa sistem bazen sorun yaşayabilir. Dosya adını düzeltip tekrar deneyin.

• PDF dönüşümünde hata alıyorum & "attempt to perform an operation not allowed by the security policy" hatası alıyorum.

  • Cevap: Pardus ve Debian tabanlı sistemlerde ImageMagick güvenlik nedeniyle varsayılan olarak PDF işlemlerini kısıtlayabilir. Bu izni açmak için:

    1. Terminalden ayar dosyasını açın:

       sudo nano /etc/ImageMagick-6/policy.xml

       (Not: Sistem sürümünüze göre klasör adı ImageMagick-7 olabilir)

    2. Dosya içinde şu satırı bulun:

       <policy domain="coder" rights="none" pattern="PDF" />

    3. "none" kısmını "read|write" olarak değiştirin:

       <policy domain="coder" rights="read|write" pattern="PDF" />

    4. Ctrl+O ile kaydedip Ctrl+X ile çıkın.