🖨️ epson-l6270-toolkit

Toolkit bash lengkap untuk mengendalikan printer Epson L6270 dari Terminal — print, jadwal, pantau antrian, dan lacak riwayat cetak, semua tanpa buka aplikasi.

---

💡 Kenapa Toolkit Ini Ada?

Kalau kamu sering cetak dokumen dari Terminal, script, atau workflow otomatis — buka aplikasi Print Dialog setiap kali itu buang waktu. Toolkit ini memungkinkan kamu mengirim file ke printer, menjadwalkan cetak, memantau antrian, dan menelusuri riwayat — semuanya dari baris perintah.

Tidak perlu install apa pun. Semua berjalan di atas CUPS yang sudah ada di macOS.

---

📦 Isi Toolkit

Script	Versi	Fungsi
print.sh	1.0.0	Print file dengan opsi lengkap
printer_status.sh	1.0.0	Monitor status printer secara real-time
batch_print.sh	1.0.0	Print banyak file sekaligus
print_scheduler.sh	1.0.0	Jadwalkan print di waktu tertentu
print_log.sh	1.0.0	Riwayat & statistik print job
print_queue_manager.sh	1.0.0	Kelola antrian cetak

---

🚀 Mulai Cepat

1. Clone repo

git clone https://github.com/yingtze/epson-l6270-toolkit.git
cd epson-l6270-toolkit
chmod +x *.sh

2. Cek nama printer kamu

lpstat -p
# printer EPSON_L6270_Series is idle. enabled since ...

Pastikan variabel PRINTER di tiap script sesuai dengan nama yang muncul.

3. Print file pertamamu

./print.sh dokumen.pdf
./print.sh laporan.pdf -c 2 -d -q high   # 2 copy, duplex, kualitas tinggi

---

📖 Panduan Per Script

print.sh — Print File

./print.sh <file> [opsi]

  -c <n>       Jumlah salinan (default: 1)
  -p <range>   Halaman tertentu, misal: 1-3 atau 1,3,5
  -d           Duplex / bolak-balik
  -o           Orientasi landscape
  -m <size>    Ukuran kertas: A4, Letter, Legal (default: A4)
  -q <level>   Kualitas: draft, normal, high (default: normal)
  -t <judul>   Judul job di antrian
  -l           Daftar semua printer yang tersedia

printer_status.sh — Monitor Status

./printer_status.sh           # cek sekali
./printer_status.sh --watch   # live update tiap 5 detik

batch_print.sh — Cetak Massal

./batch_print.sh *.pdf -c 2 -d
./batch_print.sh --from-list daftar.txt -q high --dry-run

Format daftar.txt — satu path file per baris, baris # diabaikan:

# Laporan bulanan
/Users/kamu/Dokumen/januari.pdf
/Users/kamu/Dokumen/februari.pdf

print_scheduler.sh — Jadwal Cetak

./print_scheduler.sh laporan.pdf --at 08:30
./print_scheduler.sh foto.jpg --in 15 --bg     # background, notif macOS
./print_scheduler.sh --list                    # lihat semua job terjadwal
./print_scheduler.sh --cancel <pid>            # batalkan job

print_log.sh — Riwayat & Statistik

./print_log.sh                        # 20 job terakhir
./print_log.sh -n 50 --date "Mar 15"  # filter tanggal
./print_log.sh --export riwayat.csv   # export ke CSV
./print_log.sh --stats                # statistik lengkap

print_queue_manager.sh — Kelola Antrian

./print_queue_manager.sh list
./print_queue_manager.sh cancel <job-id>
./print_queue_manager.sh cancel-all
./print_queue_manager.sh pause
./print_queue_manager.sh resume
./print_queue_manager.sh hold <job-id>
./print_queue_manager.sh release <job-id>
./print_queue_manager.sh priority <job-id> 80
./print_queue_manager.sh watch             # monitor real-time

---

🖥️ Contoh Output

📄 Batch Print — 4 file
  Printer : EPSON_L6270_Series
  Copies  : 1 | Paper: A4 | Duplex: Tidak | Quality: normal

  ▶ januari.pdf (PDF document)
     ✓ Job terkirim — request id is EPSON_L6270_Series-42
  ▶ februari.pdf (PDF document)
     ✓ Job terkirim — request id is EPSON_L6270_Series-43
  – Skipped (tidak ditemukan): maret.pdf
  ▶ april.pdf (PDF document)
     ✓ Job terkirim — request id is EPSON_L6270_Series-44

Selesai: 3 berhasil | 0 gagal | 1 dilewati

---

⚙️ Konfigurasi

Ubah variabel di baris atas tiap script sesuai kebutuhanmu:

PRINTER="EPSON_L6270_Series"   # sesuaikan dengan output lpstat -p

---

📋 Persyaratan

• macOS 10.15 Catalina atau lebih baru
• Bash 3.2+ (sudah ada di macOS)
• Driver Epson L6270 sudah terinstall
• Tools bawaan: lp, lpstat, lpq, cancel, cupsenable, cupsdisable — semua sudah ada di macOS

Tidak perlu Homebrew. Tidak perlu install apa pun.

---

📁 Struktur Repo

epson-l6270-toolkit/
├── print.sh                  # 1.0.0
├── printer_status.sh         # 1.0.0
├── batch_print.sh            # 1.0.0
├── print_scheduler.sh        # 1.0.0
├── print_log.sh              # 1.0.0
├── print_queue_manager.sh    # 1.0.0
├── CHANGELOG.md
├── README.md
├── .gitignore
└── LICENSE

---

🗺️ Rencana ke Depan

Lihat bagian [Unreleased] di CHANGELOG.md.

---

🤝 Kontribusi

Pull request terbuka untuk semua orang. Silakan buka issue terlebih dahulu untuk mendiskusikan perubahan yang ingin dibuat.

git checkout -b feat/fitur-baru
git commit -m "feat: tambah deteksi level tinta"
git push origin feat/fitur-baru

Konvensi commit: feat:, fix:, docs:, refactor:, chore:

---

📄 Lisensi

MIT — lihat LICENSE untuk detail.