ss2ssh

ss2ssh adalah skrip PowerShell yang memungkinkan kamu mengirim screenshot dari clipboard Windows langsung ke server SSH, tanpa menyimpan file lokal. Cocok untuk workflow cepat, monitoring, atau remote collaboration.

---

Fitur

• Mengambil screenshot dari Windows Clipboard.
• Mengirim gambar langsung ke host SSH tanpa menyimpan file PNG lokal.
• File PNG tersimpan dengan timestamp unik untuk mencegah overwrite.
• Kompatibel dengan Windows 10+ dan PowerShell 5+.
• Mendukung gambar dari Alt+PrintScreen atau Win+Shift+S.
• Mudah diintegrasikan dalam workflow otomatis.

---

Prasyarat

• Windows 10 / 11 dengan PowerShell.
• SSH client tersedia di PATH (bawaan Windows 10+ atau OpenSSH).
• Clipboard berisi gambar (gunakan Win+Shift+S atau Alt+PrintScreen).
• Akun SSH dengan akses write ke direktori tujuan (default /tmp/).

---

Instalasi

1. Clone repo:

git clone https://github.com/username/ss2ssh.git
cd ss2ssh

2. Jalankan PowerShell, import fungsi:

. .\ss2ssh.ps1

Titik . di depan path penting untuk dot-sourcing agar fungsi tersedia di session.

---

Penggunaan

ss2ssh user@remote.host

Output:

Screenshot berhasil dikirim ke user@remote.host: /tmp/ss-1678901234.png

File di server dapat dicek:

ssh user@remote.host "ls -lh /tmp/ss-*.png; file /tmp/ss-*.png"

---

Tips

• Gunakan Win+Shift+S untuk memilih area, atau Alt+PrintScreen untuk jendela aktif.
• Clipboard harus berisi gambar sebelum menjalankan ss2ssh.
• File PNG otomatis memiliki nama unik berbasis timestamp.

---

Contoh Integrasi Workflow

• Auto-upload screenshot setelah tangkapan layar:

# PowerShell script sederhana
while ($true) {
    Start-Sleep -Seconds 10
    if ([Windows.Forms.Clipboard]::ContainsImage()) {
        ss2ssh user@remote.host
    }
}

• Bisa digabung dengan task scheduler agar otomatis saat login atau screenshot baru tersedia.

---

Troubleshooting

Masalah	Solusi
Clipboard kosong	Pastikan screenshot sudah diambil (Win+Shift+S / Alt+PrintScreen).
File PNG kosong di server	Clipboard mungkin kosong atau transfer terputus; ulangi proses.
ssh tidak ditemukan	Pastikan SSH client ada di PATH (ssh -V).
Error encoding Base64	Pastikan fungsi PowerShell terbaru dijalankan, jangan gunakan editor yang menambahkan karakter ekstra.

---

Lisensi

MIT License – lihat file LICENSE untuk detail.

---

Kontribusi

• Fork repo ini
• Buat branch fitur baru (git checkout -b feature-namaFitur)
• Commit perubahan (git commit -m "Tambah fitur xyz")
• Push ke branch (git push origin feature-namaFitur)
• Buat Pull Request

---

Disclaimer

Gunakan skrip ini hanya pada sistem yang kamu miliki atau memiliki izin. Penulis tidak bertanggung jawab atas penggunaan ilegal.

---

Screenshots / Preview