lowkey / lowkey
lowkeyctl
Управление сохранённым сайтом из Терминала
Установка команды
Поместите lowkey 0.1.1 или новее в /Applications, затем выполните команды ниже. Скрипт создаст ссылку на утилиту внутри приложения. Он не требует sudo и не меняет настройки оболочки.
curl -fsSLo install-lowkey-cli.sh https://bobuk.io/apps/lowkey/install-cli.sh && sh install-lowkey-cli.sh
command -v lowkeyctl
lowkeyctl --helpСкрипт выбирает ~/.local/bin, ~/bin или ~/.bin, если каталог уже входит в PATH. Иначе он создаёт ссылку в ~/.local/bin и подсказывает, как добавить каталог в PATH. При обновлении приложения ссылка сохранится. Для удаления команды удалите только ссылку, путь к которой вывел скрипт.
Справочник команд
Формат: lowkeyctl АЛИАС КОМАНДА. Замените HA своим алиасом. Подписи с пробелами берите в кавычки.
| Команда | Результат |
|---|---|
| open | Показать или открыть окно сайта. |
| hide | Скрыть, не закрывая. |
| toggle | Скрыть активное окно сайта, иначе показать его. |
| rewind | Показать окно и перейти на стартовый адрес сайта. |
| status [--json] | Узнать состояние окна, не поднимая его. |
| inspect [--json] | Получить типы и подписи элементов. Введённые значения не выводятся. |
| wait [LABEL] [--timeout SECONDS] | Дождаться готовности документа или одного видимого и доступного элемента. По умолчанию 10 секунд; допустимо 1–300. |
| click LABEL | Нажать одну кнопку или ссылку. |
| fill FIELD VALUE | Заполнить текстовое поле по подписи. Поля паролей исключены. |
| select FIELD VALUE | Выбрать пункт из списка по его тексту. |
| upload FILE [--field LABEL] | Прикрепить один файл до 8 МиБ. Если на странице несколько полей для файлов, укажите подпись. |
Работа со страницей
Сначала откройте окно сайта. Команды ищут точные подписи без учёта лишних пробелов в основном документе и открытых теневых деревьях, только в пределах исходного origin. Если нет совпадений или найдено несколько, команда вернёт ошибку. Успешный click означает, что нажатие передано странице. Команда upload не отправляет форму, но сайт может сразу загрузить файл.
Начиная с lowkey 0.1.2: View → Save as PDF… (⌘⇧S) или lowkeyctl HA save-pdf ~/Desktop/page.pdf. Печатает весь текущий документ в PDF формата A4 со стилями для печати, не только видимую область. Не загружает отложенный контент и не раскрывает виртуальные списки. Команда требует открытую страницу на сохранённом origin и не перезаписывает файлы. Меню открывает диалог сохранения. Save as PDF… также есть в контекстном меню страницы.
lowkeyctl HA open
lowkeyctl HA inspect --json
lowkeyctl HA wait "Refresh list" --timeout 20 && lowkeyctl HA click "Refresh list"