geetak 0.2.0

This is a CLI for controlling GeeTak device

Geetak - Kontrol USB Relay dengan CLI !

Geetak adalah aplikasi berbasis CLI (Command-Line Interface) untuk mengontrol USB relay secara efisien. Aplikasi ini memanfaatkan protokol HID untuk menghubungkan perangkat USB relay dengan komputer Anda. Dengan Geetak, Anda dapat mengatur timer, memeriksa perangkat, dan menyinkronkan waktu dengan server NTP secara langsung melalui terminal.

---

✨ Fitur Utama

• Kontrol Timer: Mengaktifkan relay pada waktu tertentu.
• Sinkronisasi Waktu: Menyinkronkan waktu lokal dengan server NTP.
• Cek Perangkat: Memastikan perangkat USB relay Anda tersedia.
• Zona Waktu: Menyesuaikan zona waktu untuk waktu lokal.
• Progress Bar: Menampilkan progres timer dengan tampilan interaktif.

---

🚀 Instalasi

1. Persyaratan

Pastikan Anda sudah menginstal Python versi 3.8 atau lebih baru.

2. Instalasi dengan pip

Jalankan perintah berikut untuk menginstal Geetak:

pip install geetak

3. Verifikasi Instalasi

Setelah instalasi selesai, pastikan Geetak terinstal dengan benar:

geetak --help

Jika berhasil, Anda akan melihat daftar perintah yang tersedia.

---

🛠️ Cara Penggunaan

1. Memulai Timer

Gunakan perintah gas untuk mengatur timer dan mengaktifkan relay pada waktu tertentu:

geetak gas 10:00:00 --offset 500

Penjelasan:

• 10:00:00: Waktu target dalam format HH:MM:SS.
• --offset: Tambahan delay dalam milidetik (opsional).

2. Cek Waktu Server NTP

Gunakan perintah cekwaktu untuk menampilkan waktu lokal yang disinkronkan dengan server NTP:

geetak cekwaktu

3. Cek Perangkat

Gunakan perintah cekalat untuk memastikan perangkat USB relay tersedia:

geetak cekalat

4. Ubah Zona Waktu

Gunakan perintah ubahzona untuk menyesuaikan zona waktu (dalam jam):

geetak ubahzona +7

---

📖 Contoh Penggunaan

Berikut adalah contoh skenario penggunaan Geetak:

1. Anda ingin menghidupkan relay pada pukul 10:30:00 WIB dengan tambahan delay 200 ms:

   geetak gas 10:30:00 --offset 200
   

2. Anda ingin memeriksa apakah perangkat USB relay Anda sudah terhubung:

   geetak cekalat
   

3. Anda ingin menyinkronkan waktu lokal Anda dengan server NTP:

   geetak cekwaktu
   

---

💡 Tips dan Trik

• Pastikan perangkat USB relay Anda sudah terhubung sebelum menjalankan perintah.
• Gunakan perintah ubahzona untuk menyesuaikan zona waktu lokal Anda (misalnya, +7 untuk WIB).

---

🛡️ Lisensi

Proyek ini dilisensikan di bawah lisensi MIT.

---

🤝 Kontribusi

Kami terbuka untuk kontribusi! Jika Anda ingin membantu mengembangkan Geetak, silakan:

1. Fork repository ini.
2. Buat branch baru untuk fitur atau perbaikan Anda.
3. Kirimkan pull request.

---

📞 Dukungan

Jika Anda memiliki pertanyaan atau menemukan masalah, jangan ragu untuk menghubungi kami melalui Issues.

---

⭐ Dukung Kami

Jika Geetak bermanfaat untuk Anda, jangan lupa memberikan bintang ⭐ di repository ini!