chaeruldesktop 0.1.7

Code ini di buat untuk meringkas kode tkinter menjadi lebih mudah. support terus ya :)

Custom Tkinter UI Components

Repo ini berisi kumpulan komponen UI untuk Python menggunakan tkinter dan customtkinter.
Memudahkan pembuatan aplikasi desktop dengan tampilan modern dan fungsi tambahan seperti input dengan ikon, tombol toggle password, progress bar, dan lainnya.

---

Instalasi

Pastikan kamu sudah install Python 3.x dan pip.
Install dependencies berikut:

pip install chaeruldesktop

Import Library

Import

from chaeruldesktop import *

komponen terbaru

kamu dapat memanggil komponen icons yang telah saya sediakan agar memudahkan anda dapat membuat aplikasi desktop, dengan ini semoga membantu anda, berikut beberapa yang telah saya tambahkan.

untuk menggunakan nya kamu harus memanggil nya seperti berikut:

icons['_name_']

Icons

• user # User Icon: Digunakan untuk menampilkan avatar atau simbol user
• lock # Lock Icon: Digunakan untuk input password atau simbol keamanan
• eye # Eye Icon: Untuk toggle visibility password
• search # Search Icon: Digunakan untuk tombol atau input pencarian
• cart # Shopping Cart Icon: Menunjukkan keranjang belanja
• crossed_eye # Crossed Eye Icon: Untuk sembunyikan password
• app # App Icon: Ikon utama aplikasi

contoh cara pakai icons

• width # Atur lebar gambar
• height # Atur tinggi gambar contoh cara pakai icons

ImageViewPilLow(parent, icons["user"], width=100, height=100)

namun anda bisa memakai tanpa width dan height contoh kode.

ImageViewPilLow(parent, icons["user"])

Colors

Library menyediakan warna standar untuk UI:

• primary # Biru (default tombol utama)
• secondary # Abu-abu
• success # Hijau
• danger # Merah
• warning # Kuning/oranye
• info # Biru muda/cyan
• light # Putih/terang
• dark # Hitam/gelap

Contoh penggunaan:

colors['success'] # Hijau

Tombol(Button)

widget membuat tombol button dan berikut parameter yang bisa anda terapkan.

Parameter

• parent # Parent widget tempat tombol diletakkan
• text # Teks yang tampil pada tombol (default "Click")
• backgroundColor # Warna background tombol (default warna primary dari Colors())
• textColor # Warna teks tombol (default "white")
• radius # Radius sudut tombol (default 10)
• width # Lebar tombol (default 120)
• height # Tinggi tombol (default 40)
• command # Fungsi yang dijalankan saat tombol ditekan (default None)

contoh kode sederhana tanpa parameter

Contoh Pakai

buttonView(
    parent,
),

dan berikut kode ynag menggunakan parameter

Contoh Pakai

buttonView(
    parent,
    "Login",
    radius=10,
    width=300,
    backgroundColor=colors['success'],
    textColor="white"
),

appDesktop

Membuat jendela utama aplikasi.

• title # Judul aplikasi
• icon # Path ikon aplikasi
• width # Lebar jendela
• height # Tinggi jendela
• body # List fungsi builder untuk widget
• on_ready # Fungsi dijalankan saat GUI siap
• align # Posisi body (start, center, end, dll.)

Contoh Pakai

from chaeruldesktop.app_desktop import *

appDesktop(
    title="My App", # atur title
    icon=icons["app"], # atur icon
    width=400, # atur ukuran lebar 
    height=300, # atur ukuran tinggi
    body=[
        lambda parent: ImageViewPilLow(parent, icons["user"], width=100, height=100),
    ],
    align='center' # atur letak widget anda bisa atur "center" atau "center|bottom"
)

Daftar Fungsi Library ChaerulDesktop

• textView # Membuat label teks sederhana dengan kustomisasi warna, font, dan ukuran
• safe_callback # Membungkus callback agar error ditangani dengan print dan popup
• Colors # Mengembalikan dictionary warna standar untuk UI (primary, secondary, success, dll.)
• buttonView # Membuat tombol kustom dengan warna, radius, ukuran, dan command
• progressView # Membuat progress bar dengan mode, orientasi, dan nilai awal
• styleInput # Mengembalikan dictionary style untuk input field (width, font, border, bg)
• load_icon # Load ikon dari folder resources dan ubah ke CTkImage
• inputView # Membuat input field dengan ikon, placeholder, tombol toggle mata, dan style
• ImageViewPilLow # Membuat label dengan gambar PIL yang di-resize sesuai ukuran
• appDesktop # Membuat jendela utama aplikasi dengan title, icon, ukuran, body, dan alignment

---

Library ini di bangun oleh Chaerul mahasiswa politeknik baja tegal.