desktoppr
v0.5
desktoppr !Alat baris perintah sederhana yang dapat membaca dan mengatur gambar/wallpaper desktop. Penghargaan atas nama Neil Martin.
Catatan: Apple biasa menyebut gambar latar belakang macOS 'gambar desktop' hingga macOS 13 Ventura, ketika diubah menjadi sama seperti di iOS: 'wallpaper'. Dokumentasi ini mungkin menggunakan kedua istilah tersebut.
Saya telah menulis beberapa postingan blog yang menjelaskan berbagai strategi penggunaan untuk mengatur gambar desktop:
Menggunakan desktoppr di lingkungan terkelola
Membangun pkg Penginstal LaunchD untuk desktoppr (dan alat lainnya)
Strategi menggunakan desktoppr
Latar Belakang Desktop Acak dengan desktoppr
Anda dapat membaca gambar/wallpaper desktop saat ini dengan:
$ desktoppr /Library/Desktop Pictures/Sierra.jpg
dan atur gambar desktop dengan
$ desktoppr "/Library/Desktop Pictures/BoringBlueDesktop.png"
Jika Anda memiliki beberapa tampilan, desktoppr akan mencantumkan semua gambar desktop:
$ desktoppr /Library/Desktop Pictures/HotStepper.jpg /Library/Desktop Pictures/LyricalGangster.jpg /Library/Desktop Pictures/MrOfficer.jpg
Saat Anda meneruskan file, desktoppr akan menetapkannya sebagai gambar desktop untuk semua layar:
$ desktoppr /Library/Desktop Pictures/NaahNananah.jpg $ desktoppr /Library/Desktop Pictures/NaahNananah.jpg /Library/Desktop Pictures/NaahNananah.jpg /Library/Desktop Pictures/NaahNananah.jpg
Anda juga dapat mengatur desktop untuk layar tertentu: (indeks dimulai dari nol)
$ desktoppr 0 /Library/Desktop Pictures/HotStepper.jpg $ desktoppr 1 /Library/Desktop Pictures/LyricalGangster.jpg $ desktoppr 2 /Library/Desktop Pictures/MrOfficer.jpg
desktoppr juga dapat mengontrol skala gambar dan warna latar belakang gambar desktop.
Pengaturan skala dan warna akan diatur untuk semua layar.
Gunakan kata kerja scale untuk mengontrol bagaimana desktop diskalakan. Itu dapat memiliki nilai fill (default), stretch , center , atau fit .
$ desktoppr scale center
Anda dapat memberikan string hex untuk warna latar belakang:
$ desktoppr color 000000 # black background $ desktoppr color FFFFFF # white background $ desktoppr color FF0000 # red background
Mengatur wallpaper, skala dan/atau warna adalah perintah terpisah.
Catatan: pengaturan warna latar belakang tidak berfungsi di macOS 14.x. Lihat edisi #22.
Saat Anda memberikan URL ke file gambar sebagai argumen, desktoppr akan mengunduh file dari URL tersebut dan menetapkannya sebagai wallpaper.
$ desktoppr https://raw.githubusercontent.com/scriptingosx/desktoppr/profile/examples/BoringBlueDesktop.png
File yang diunduh akan disimpan di ~/Library/Application Support/desktoppr/ .
Jika pengunduhan gagal, wallpaper tidak akan diubah. Jika file yang diunduh bukan file gambar, wallpaper akan kembali ke default sistem.
Saat Anda ingin menjalankannya dari skrip, cara paling aman adalah menyertakan seluruh jalur ke biner:
/usr/local/bin/desktoppr "/Library/Desktop Pictures/BoringBlueDesktop.png"
Karena alat desktoppr menetapkan preferensi pengguna, Anda tetap perlu memperhatikan bahwa alat tersebut dijalankan sebagai pengguna. LaunchAgent atau solusi seperti outset adalah pilihan yang baik untuk mengelola ini. Alternatifnya, Anda dapat menjalankan perintah sebagai pengguna saat ini dari skrip root.
Saat Anda menjalankan desktoppr dengan kata kerja manage , pengaturan dari domain preferensi com.scriptingosx.desktoppr akan dibaca. Anda dapat mengatur pengaturan ini dengan perintah defaults atau, sebaiknya, dengan memasukkan profil konfigurasi dari server MDM.
Idenya adalah menjalankan desktoppr manage dengan plist LaunchAgent saat login dan/atau secara berkala. Anda dapat menemukan contoh daftar LaunchAgent di sini. Contoh LaunchAgent akan menjalankan desktoppr manage saat login dan setiap tiga jam (10800 detik). Anda dapat membuat pkg yang menginstal biner desktoppr, plist LaunchAgent, dan file gambar di awal alur kerja penerapan, lalu desktoppr menyetel latar belakang desktop saat pengguna membuka desktop untuk pertama kalinya.
Untuk Ventura dan yang lebih tinggi, biner dan aplikasi yang dijalankan oleh LaunchAgents harus disetujui dengan profil com.apple.servicemanagement sehingga muncul sebagai terkelola di bagian item login di Pengaturan.app. Contoh profil konfigurasi juga berisi pengaturan tersebut.
desktoppr menggunakan kunci berikut:
picture (ketik: string )Jalur ke file gambar untuk gambar/wallpaper desktop. Gambar yang sama akan disetel untuk semua layar.
Ketika nilainya dimulai dengan http:// atau https:// desktoppr akan menafsirkan ini sebagai URL dan mencoba mengunduh file dan mengatur file tersebut sebagai gambar/wallpaper desktop. File yang diunduh akan disimpan di ~/Library/Application Support/desktoppr/ . Anda dapat meminta desktoppr memverifikasi file gambar yang diunduh dengan menyediakan checksum sha256 .
sha256 (ketik: string )Checksum sha256 ini akan digunakan untuk memverifikasi file gambar yang diunduh. Jika checksum dari file yang diunduh tidak sesuai dengan nilai kunci ini, gambar/wallpaper desktop tidak akan diubah.
Anda dapat membuat checksum sha256 dari file gambar dengan shasum -a 256
color (tipe: string )String ini akan ditafsirkan sebagai kode hex enam digit dan ditetapkan sebagai warna latar belakang. (Catatan: pengaturan warna rusak di macOS 14.x.)
scale (ketik: string ) Salah satu fill (default), stretch , center , atau fit . Ini mengontrol perilaku penskalaan gambar.
setOnlyOnce (ketik: boolean, default: false ) Jika disetel ke true , desktoppr manage tidak akan menyetel ulang gambar/wallpaper desktop jika gambar terakhir yang disetel desktoppr manage sama. Gunakan ini untuk mengatur gambar/wallpaper desktop satu kali dari profil konfigurasi tetapi mengizinkan pengguna untuk mengubahnya setelahnya. Meskipun desktoppr manage sering dijalankan, ini hanya akan mengatur ulang gambar/wallpaper desktop ketika pengaturan di profil konfigurasi berubah.
Jika disetel ke false , desktoppr manage akan menerapkan kembali pengaturan terkelola setiap saat.
Contohnya memiliki contoh plist default dengan kunci dan contoh profil konfigurasi.
Anda bisa mendapatkan kode untuk desktoppr di halaman Github saya dan penginstal di Rilis. Pemasang pkg akan memasang biner di /usr/local/bin . Alternatifnya, ada brew cask, jadi Anda bisa menginstalnya menggunakan brew install --cask desktoppr jika Anda sudah menginstal Homebrew.
Alat ini memerlukan dukungan Swift 5 Runtime untuk alat baris perintah saat Anda menginstalnya pada versi macOS yang lebih lama dari 10.14.4.
