CTk Tasarım Stüdyosu

Bir aracı pencereye sürükleyip bırak ya da tıklayarak ekle.

– ☐ ✕

Özellikler

Senin kodun Sadece normal Python yaz.

1

Tasarımın ve araç isimleri

İsme tıkla, koduna eklensin:

Yapay zeka yardımcısı

Bağlantı ayarları
Model

Butonlar hangi fonksiyonu çalıştırıyor?

Kopya kağıdı

Bildiğin input() ve print() burada pencereyle çalışır.


    

Kontrol

VS Code'da çalıştır

    Tasarımı veya kodu değiştirirsen buraya dönüp tekrar kopyala.

    Exe yapmak istersen

    Program VS Code'da çalıştıktan sonra, Python kurulu olmayan Windows bilgisayarlarda da açılan tek bir dosyaya çevirebilirsin.

      İçindekiler

      Nasıl çalışır?

      Bu sitede pencereni çizerek tasarlarsın, yanına sadece normal Python yazarsın. Site ikisini birleştirip VS Code'da çalışan tek bir dosya üretir.

      1. Tasarla: Soldaki araç kutusundan bir aracı pencereye sürükleyip bırak (ya da tıkla, pencereye eklensin). Sürükleyerek yerini, sağ alt köşesinden tutarak boyutunu değiştir. Sağdaki panelden ismini ve ayarlarını yap.
      2. Kodla: Butona basılınca ne olacağını Python ile yaz. Araçlara tasarımda verdiğin isimlerle ulaşırsın.
      3. Kopyala: "Kodun tamamını kopyala"ya bas, VS Code'da uygulama.py dosyasına yapıştır ve çalıştır.

      Kopyalamadan önce programını sitede denemek için Tasarla ya da Kodla adımındaki Dene düğmesine bas.

      Tasarımı ya da kodu her değiştirdiğinde Kopyala adımına dönüp kodu yeniden kopyalaman gerekir.

      İki temel komut: input ve print

      Konsolda bildiğin input() ve print() burada pencereyle çalışır. Hepsi bu dört kullanım:

      isim = input(giris1)              # giris1 aracının içindeki değeri al
      yas = input("Kaç yaşındasın?")    # küçük bir soru penceresi aç, cevabı al
      print("Merhaba", isim)            # çıktı alanına yaz
      print("Merhaba", file=etiket1)    # doğrudan etiket1 aracının içine yaz
      • Çıktı alanı: Tasarla adımında bir etiketi ya da metin alanını seçip "print() yazıları burada görünsün" kutusunu işaretlersen, düz print() oraya yazar. İşaretli araç yoksa yazı VS Code terminalinde görünür.
      • Yazı ve sayı: Giriş kutusundan gelen değer her zaman yazıdır (str). Onunla hesap yapacaksan int() ya da float() ile sayıya çevir.

      Bir aracın içini boşaltmak için temizle() kullanılır. Giriş kutusu, metin alanı, etiket, liste kutusu ve çizim alanında çalışır:

      temizle(giris1)    # kutudaki yazıyı sil
      temizle(metin1)    # metin alanını boşalt

      Hangi araçta ne olur?

      Butona fonksiyon bağlama

      Bir buton eklediğinde site ona bir fonksiyon adı verir (örneğin buton1_tiklandi) ve Kodla adımına boş halini ekler. Butona basılınca o fonksiyonun içindeki kod çalışır.

      def buton1_tiklandi():
          isim = input(giris1)
          print("Merhaba", isim + "!")
      • Fonksiyonun parantezi boş olur, içine parametre yazılmaz.
      • Fonksiyon adını butonun özelliklerindeki "Tıklanınca çalışacak fonksiyon" kutusundan değiştirebilirsin.
      • Onay kutusu, anahtar, kaydırıcı ve listelere de fonksiyon bağlanabilir; değer her değiştiğinde çalışır.
      • Kodla adımındaki "Butonlar hangi fonksiyonu çalıştırıyor?" kutusu, eksik fonksiyon varsa gösterir.

      Bir değeri fonksiyonlar arasında saklamak istersen (örneğin puan), fonksiyonun dışında tanımla ve içinde global yaz:

      puan = 0
      
      def arti_tiklandi():
          global puan
          puan = puan + 1
          print("Puan:", puan)

      Araçlar

      Her aracın ne işe yaradığı, input() ile ne verdiği, print(..., file=...) ile ne yaptığı ve kısa bir örnek. Örneklerdeki isimler (giris1, etiket1 gibi) senin tasarımındaki isimlerle aynı olmalı.

      Tasarım kolaylıkları

      • Kaplar: Sekmeli alan ve kaydırılabilir çerçeve içine araç koyulan kaplardır. Bir kabın içine başka bir kap da koyabilirsin (örneğin bir sekmenin içine kaydırılabilir çerçeve). Bir aracı kabın üstüne bırakırsan içine girer, dışarı sürüklersen çıkar. Kabı taşıdığında, kopyaladığında ya da sildiğinde içindekiler de onunla gider.
      • Kılavuz çizgileri: Bir aracı sürüklerken başka bir araçla ya da pencerenin ortasıyla hizalandığında pembe bir çizgi görünür ve araç oraya yapışır. Yapışmasın istersen Alt tuşunu basılı tut.
      • Çoklu seçim: Shift tuşuna basılı tutup araçlara tıkla. Seçili araçları birlikte sürükleyebilir, ok tuşlarıyla kaydırabilir, kopyalayabilir ya da silebilirsin. Ctrl+A sayfadaki bütün araçları seçer.
      • Hizalama: Birden fazla araç seçiliyken sağdaki panelde "Sola", "Yatay ortala", "Üste" gibi hizalama düğmeleri ve "eşit aralıkla diz" düğmeleri çıkar. Tek araç seçiliyken onu pencerede ortalayan iki düğme vardır.
      • Öne getir / Arkaya gönder: Üst üste binen araçlardan hangisinin üstte duracağını belirler.
      • Geri al: Yanlış yaptığın tasarım değişikliğini geri alır (Ctrl+Z).
      • Hiyerarşi: Soldaki "Hiyerarşi" sekmesi bütün sayfaları ve içlerindeki araçları listeler.

      Dene: programı sitede çalıştırma

      Tasarla ya da Kodla adımındaki Dene düğmesi programını sitenin içinde çalıştırır. Butonlara basabilir, kutulara yazabilir, sayfalar arasında geçebilirsin. Yazdığın Python kodu gerçekten çalışır.

      • Terminal: Sağdaki kutu bütün print() yazılarını ve hataları gösterir. Hata olursa hangi satırda olduğu ve ne anlama geldiği yazar.
      • Baştan başlat: Kodu ya da tasarımı değiştirdikten sonra denemeyi yeniden başlatır.
      • İlk açılış: Python çalıştırıcısı ilk seferde internetten indirilir (yaklaşık 10 MB), bu yüzden biraz bekletir.
      • Farklar: Görünüş gerçek programla birebir aynı değildir. Resim değiştirme ve video burada gösterilmez; input("soru") tarayıcının kendi soru kutusunu açar. Son kontrol için programı yine VS Code'da çalıştır.
      • Sonsuz döngü: Bir döngü 4 saniyeden uzun sürerse Dene onu durdurur ve terminalde hangi satırdaki döngünün bitmediğini yazar. Editör de içinde break olmayan while True döngülerini işaretler. VS Code'da çalışan programda da koruma vardır: bir butonun işi 10 saniyeden uzun sürerse durdurulur ve uyarı penceresi çıkar. Bu süre pencere ayarlarındaki "Sonsuz döngü koruması"ndan değişir.

      Sayfalar

      Butona basınca yeni bir ekran açılsın istiyorsan sayfa kullan. Pencere aynı kalır, içindeki sayfa değişir.

      1. Tasarla adımında pencerenin üstündeki "+ Sayfa ekle"ye bas ve yeni sayfayı tasarla.
      2. İlk sayfaya dön, butonu seç, "Tıklanınca açılacak sayfa" ayarından gideceği sayfayı seç. Bunun için kod yazman gerekmez.
      3. Geri dönmek için ikinci sayfaya da bir buton koy ve onu ilk sayfaya bağla.

      Sayfayı bir şarta göre açmak istersen kodda sayfa_ac() kullan:

      def giris_tiklandi():
          if input(sifre) == "1234":
              sayfa_ac(sayfa2)
          else:
              print("Şifre yanlış")
      • En baştaki sayfa, program açılınca görünen sayfadır. Sırayı "← Öne al" ve "Sona al →" ile değiştirirsin.
      • Soldaki "Hiyerarşi" sekmesi bütün sayfaları ve içlerindeki araçları listeler.
      • Araç isimleri bütün sayfalarda farklı olmalıdır; başka sayfadaki araca da ismiyle ulaşabilirsin.
      • Arka plan: Pencerede boş bir yere tıkla; sağdaki panelden o sayfanın arka plan rengini ya da arka plan resmini seçebilirsin. Resim kodun içine gömülür. Resmin üstündeki etiketlerin arkası düz renk görünür.

      Dosyaya kaydetme ve dosyadan okuma

      Program kapanınca kaybolmasını istemediğin bilgileri (puan, notlar, isim listesi) bir dosyaya yazabilirsin. Bunun için Python'un kendi open() komutu kullanılır. Dosya, uygulama.py ile aynı klasörde oluşur.

      def kaydet_tiklandi():
          dosya = open("puan.txt", "w", encoding="utf-8")   # "w": yaz (eskisinin üstüne)
          dosya.write(input(giris1))
          dosya.close()
          print("Kaydedildi")
      
      
      def yukle_tiklandi():
          dosya = open("puan.txt", "r", encoding="utf-8")   # "r": oku
          yazi = dosya.read()
          dosya.close()
          print(yazi, file=etiket1)
      • "w" dosyayı baştan yazar, "a" sonuna ekler, "r" okur.
      • Olmayan bir dosyayı okumaya çalışırsan hata alırsın. Önce var mı diye bakabilirsin: if os.path.exists("puan.txt"):
      • Dene modunda dosyalar sadece o deneme boyunca saklanır; sayfa yenilenince silinir.
      • Hazır örneklerdeki "Not Defteri" bunun çalışan bir örneğidir.

      Yapay zeka

      Yapay zeka iki ayrı yerde kullanılır: sitede sana yardım eden yardımcı ve kendi programının içinden çağırdığın yapay_zeka() fonksiyonu.

      Bağlantıyı kurma

      1. Kodla adımında "Yapay zeka yardımcısı" kutusundaki "Bağlantı ayarları"nı aç.
      2. "Nereye bağlansın?" listesinden birini seç:
        • Groq: Ücretsiz anahtarı console.groq.com/keys adresinden al.
        • Gemini: Ücretsiz anahtarı aistudio.google.com/apikey adresinden al.
        • Ollama: Yapay zeka kendi bilgisayarında çalışır, anahtar gerekmez. Ollama kurulu ve bir model indirilmiş olmalı; ayarlar kutusu yazman gereken izin komutunu gösterir.
      3. Anahtarı kutuya yapıştır, "Modelleri getir"e bas ve listeden bir model seç.
      4. Yanındaki işaret "hazır" olunca soru sorabilirsin.

      Yardımcı, site claude.ai içinde açıkken çalışmaz. Siteyi kendi adresinden ya da bilgisayarındaki dosyadan açman gerekir.

      Yardımcıya soru sorma

      Sorunu kutuya yazıp "Gönder"e bas. VS Code'da hata aldıysan hata mesajını olduğu gibi yapıştırabilirsin. Hazır düğmeler de var: "Hatamı bul", "Kodumu açıkla", "Sıradaki adım ne?".

      • Ne gönderilir: Sorunla birlikte tasarımındaki sayfa ve araç isimleri ile o an yazdığın kod, seçtiğin servise gönderilir. Bu yüzden yardımcı senin araç isimlerinle cevap verebilir.
      • Ne gelir: Türkçe bir açıklama ve gerekirse kod. Kodun altındaki "Koda ekle" onu imlecin olduğu yere yazar, "Kopyala" panoya alır.
      • Yardım şekli: Ayarlardan "sadece ipucu versin, kodu yazmasın" seçilirse yardımcı çözümü yazmaz, yol gösterir.
      • Hatırlama: Yardımcı o sohbetteki son mesajları hatırlar. "Sohbeti temizle" baştan başlatır.

      İyi soru örnekleri:

      • "buton1'e basınca giris1'deki sayının karesini sonuc etiketine yazdırmak istiyorum."
      • "Bu hatayı aldım: ValueError: invalid literal for int(). Neden oldu?"
      • "Şifre doğruysa sayfa2 açılsın, yanlışsa uyarı çıksın."

      Programın içinden yapay zekaya sorma

      yapay_zeka("soru") soruyu yapay zekaya gönderir ve cevabı yazı (str) olarak geri verir. Cevabı bir değişkene alıp istediğin gibi kullanırsın.

      def sor_tiklandi():
          soru = input(giris1)
          cevap = yapay_zeka(soru)
          print(cevap)

      İkinci bilgi olarak nasıl davranacağını söyleyebilirsin:

      def cevir_tiklandi():
          yazi = input(giris1)
          cevap = yapay_zeka(yazi, rol="Sana verilen yazıyı İngilizceye çevir. Sadece çeviriyi yaz.")
          print(cevap, file=sonuc)

      Sohbet robotu örneği (bir giriş kutusu, bir buton ve çıktı alanı olarak işaretlenmiş bir metin alanı ile). hatirla=True yazarsan yapay zeka önceki konuşmayı da hatırlar:

      def gonder_tiklandi():
          mesaj = input(giris1)
          print("Sen:", mesaj)
          temizle(giris1)
          cevap = yapay_zeka(mesaj, rol="Kısa ve neşeli cevap ver.", hatirla=True)
          print("Robot:", cevap)
      • Ne gönderilir: Sadece parantez içine yazdığın soru ve rol. Tasarımın ya da kodun gönderilmez.
      • Anahtar: Program yapay zekaya ilk sorduğunda anahtarını yıldızlı bir kutuyla ister. Ollama'da anahtar sorulmaz.
      • Bekleme: Cevap gelene kadar pencerenin altında "Yapay zeka düşünüyor…" yazısı görünür. Pencere donmaz ama cevap gelene kadar butonlara basılamaz.
      • Hatırlama: Normalde her yapay_zeka() çağrısı ayrıdır ve öncekini hatırlamaz. hatirla=True yazarsan önceki sorularla cevapları da gönderir. Konuşmayı sıfırlamak için yapay_zeka_unut() yaz.
      • Hata olursa: Program çökmez; cevap yerine "Anahtar kabul edilmedi" ya da "Ücretsiz kullanım sınırı doldu" gibi bir yazı gelir.
      • Hangi servis: Kod, Kodla adımındaki bağlantı ayarlarında seçili olan servise ve modele gider. Ayarı değiştirirsen kodu yeniden kopyala.

      Tasarımı yapay zekaya çizdirme

      Tasarla adımındaki "Yapay zekaya çizdir" düğmesine bas, ne yapmak istediğini yaz (örneğin "boy ve kilo girilen, butona basınca vücut kitle indeksini yazan program"). Yapay zeka araçları sayfaya yerleştirir, isterse örnek kodu da yazar.

      • Önce bağlantıyı kurmuş olman gerekir.
      • Sonucu beğenmezsen "Geri al" tasarımı eski haline döndürür. Koda sonradan dokunmadıysan eklenen kod da geri alınır.
      • Yapay zekanın çizdiği tasarım bir başlangıçtır: araçların yerini, yazısını ve kodunu kendin düzelt.

      Güvenlik

      • Anahtar hiçbir yere kaydedilmez. Siteyi kapatınca, yenileyince ya da 20 dakika kullanmayınca silinir.
      • Anahtar kopyaladığın koda da yazılmaz. Bu yüzden uygulama.py dosyanı arkadaşınla paylaşabilirsin.
      • Anahtarını kimseyle paylaşma. İşin bitince "Anahtarı ve sohbeti şimdi sil"e basabilirsin.
      • Yapay zekaya adını, adresini, telefonunu ya da şifrelerini yazma. Yazdıkların seçtiğin servise gider.
      • Yapay zeka yanlış cevap verebilir. Verdiği kodu çalıştırıp dene, anlamadığın satırı sor.

      Projeyi kaydetme ve hazır örnekler

      • Otomatik kayıt: Tasarımın ve kodun bu tarayıcıda kendiliğinden saklanır; sayfayı kapatıp açınca kaldığın yerden devam edersin.
      • Dosyaya kaydet: Sağ üstteki "Kaydet / Aç" düğmesi projeyi .json dosyası olarak indirir. Bu dosyayı ödev olarak teslim edebilir ya da başka bilgisayarda "Dosyadan aç" ile açabilirsin.
      • Hazır örnekler: "Yeni / Örnekler" düğmesinde çalışan örnek projeler vardır: Selam Makinesi, Hesap Makinesi, Sayı Tahmin Oyunu, Bilgi Yarışması, Sohbet Robotu, Not Defteri ve Çizim Tahtası. Birini açıp "Dene" ile çalıştır, sonra kodunu değiştirerek öğren.

      VS Code'da çalıştırma ve exe

      1. Kopyala adımında "Kodun tamamını kopyala"ya bas ya da "uygulama.py olarak indir" ile dosyayı indir.
      2. Kopyaladıysan VS Code'da uygulama.py dosyasına yapıştır ve kaydet.
      3. Video kullandıysan video dosyasını uygulama.py ile aynı klasöre koy. Resimler kodun içindedir, taşıman gerekmez.
      4. İlk seferde terminale Kopyala adımında yazan pip install ... satırını yaz.
      5. Çalıştır düğmesine bas.

      Kopyala adımındaki "Kontrol" kutusu, eksik fonksiyon ya da pencereden taşan araç gibi sorunları kopyalamadan önce gösterir. Python kurulu olmayan bilgisayarlarda da açılan bir exe yapmak için aynı adımdaki "Exe yapmak istersen" kutusundaki komutları kullan.

      Sık yapılan hatalar

      • Sayılar yan yana yazılıyor ("5" + "3" = "53"): Giriş kutusundan gelen değer yazıdır. int(input(giris1)) yaz.
      • ValueError: invalid literal for int(): Kutu boş ya da içinde sayı olmayan bir şey var. Önce kutuya sayı yazıldığından emin ol.
      • NameError: name '...' is not defined: Kodda yazdığın isim tasarımdaki isimle aynı değil. Kodla adımındaki isim düğmelerine tıklayarak ekle.
      • Program dondu ya da "Sonsuz döngü olabilir" uyarısı çıktı: Büyük ihtimalle bitmeyen bir döngü var (while True ya da koşulu hiç değişmeyen bir while). Pencereli programlarda butonun fonksiyonu çabucak bitmelidir. Önce Dene ile çalıştır; döngü bitmiyorsa hangi satırda olduğunu söyler.
      • Butona basınca hiçbir şey olmuyor: Butona bağlı fonksiyon kodda yok ya da adı farklı. "Butonlar hangi fonksiyonu çalıştırıyor?" kutusuna bak.
      • print yazısı pencerede görünmüyor: Çıktı alanı işaretlenmemiş, yazı terminale gidiyor. Bir etikette "print() yazıları burada görünsün" kutusunu işaretle ya da file= kullan.
      • Resim görünmüyor: Tasarımda seçtiğin resimler kodun içine gömülür, dosya taşımak gerekmez. "Resim için terminale yaz: pip install pillow" yazıyorsa terminale o komutu yaz. "Resim bulunamadı" yazıyorsa resim gömülmemiştir (dosya adı elle yazılmış ya da print("x.png", file=resim1) ile değiştirilmiştir); o dosyayı uygulama.py ile aynı klasöre koy.
      • Tasarımı değiştirdim ama program aynı: Kodu Kopyala adımından yeniden kopyalayıp yapıştırman gerekir.
      • Editörde satır numarası kırmızı oldu: O satırda olası bir yazım hatası var. Editörün altındaki uyarıya tıkla, satıra gider.
      • Koda mainloop() ya da import customtkinter yazdım: Gerek yok, site bunları kendisi ekler. O satırları sil.

      Projeyi kaydet ya da aç

      Proje dosyası tasarımını ve kodunu birlikte saklar. Ödev olarak teslim edebilir ya da başka bilgisayarda açabilirsin.

      Dosya inmezse aşağıdaki yazıyı kopyalayıp saklayabilir, sonra buraya yapıştırıp yükleyebilirsin.

      Deneme

      – ☐ ✕

      Terminal

      
            

      Burada kodun gerçekten çalışır: butonlara bas, kutulara yaz. Görünüş gerçek programdan biraz farklı olabilir. Resim değiştirme, video ve ses burada gösterilmez.

      Yapay zekaya çizdir

      Ne yapmak istediğini yaz, yapay zeka araçları bu sayfaya yerleştirsin. Beğenmezsen "Geri al" ile eski tasarıma dönersin.

      Yeni proje

      Şu anki tasarımın ve kodun yerine seçtiğin proje gelir. Saklamak istiyorsan önce "Kaydet / Aç" ile kaydet.