Документация по Shark Remote

Устаревшая информация по приложению, которое поможет настроить удаленный доступ к PC через мессенджер Telegram Актуальная документацяи на Codeberg

Содержание

Описание настроек

1. Файл конфигурации Shark Remote (main.toml) 2. Пользовательские переменные (variables.txt) 3. Другие настройки

❗Рекомендуется не изменять значения вручную, а использовать для этого Настройки и Другие настройки в приложении Shark Remote❗

===== Файл конфигурации Shark Remote (main.toml) =====
Все настройки будут описаны следующим видом
настройка = описание = принимаемые значения

[BOT] - Настройки бота

token = токен бота = токен вашего бота
admin = пользователь с доступом к боту (администратор бота) = username пользователя в Telegram
notifications = управление уведомлениями (включение/отключение компьютера) для администратора бота = Ваш UserID в Telegram (пример: 85875589)

imgbb_api_key = API ключ для сервиса ImgBB для публикации скриншота с помощью команд /screen w и /screen u (подробнее) = API ключ

[GEOLOCATION] - Настройки определения геолокации PC с помощью бота

selected_service = выбранный сервис для получения геолокации (ipinfo.io, ipwhois.io, ipgeolocation.io) = цифра сервиса в списке начиная с "0" (например: ipgeolocation.io равен2), по умолчанию значение равно 0
ipgeolocationio_api_key = API ключ для сервиса ipgeolocation для публикации скриншота с помощью команды /geo (API ключ используется только при значении 2 для selected_service) = API ключ

[PRINT_OPTIONS] - Настройки печати текста

font = шрифт для печати = название шрифта
size = размер шрифта для font = число

[UI] - Настройки интерфейса приложения

use_rounded_window_frame_style = использовать скругления при отрисовке окна = false или true
use_window_mini_mode = использовать Мини-режим для основного окна управления ботом = false или true
menu_color = цвет полоски выбора в меню приложения = default, native (цвет с учётом акцентного цвета в Windows), keyboard, unigram, vivaldi, github, μtorrent, happy_new_year, happy_new_year_with_icons, happy_new_year_with_icons_and_hide_log
use_window_transparency = использовать прозрачность для окон = false или true
use_window_animation = использовать анимацию плавного появления окна = false или true (false при значении true для use_window_transparency)
use_forced_performance = использовать Режим производительности для приложения (используйте только на крайне слабых PC) = 0 - выключить, 1 - включить, 2 - выключить и никогда не предлагать использовать (для виртуальных машин VirtualBox и VMware)

[OTHER] - Другие настройки (рекомендуется не изменять)

config_version = версия конфигурационного файла для определения совместим ли конфигурационный файл с данной версией/сборкой Shark Remote = версия конфигурационного файла
hidden_bot_parameters = скрытые настройки для бота, изменять значения только опытным пользователям = ?
hidden_application_parameters = скрытые настройки для приложения, изменять значения только опытным пользователям = ?

===== Пользовательские переменные (variables.txt) =====

Пользовательские переменные, которые могут принимать любые строковые значения для использования в сочетании с командами для более быстрого доступа к необходимому функционалу или упрощению ввода аргументов к командам бота. Посмотреть список всех пользовательских переменных можно с помощью кнопки 📦+🪴 Пользовательские в меню бота, в настройках приложения или открыв файл variables.txt.

Пример:
s32=C:\Windows\System32

Теперь используем переменную в боте:
/run :s32:
После ввода команды, откроется папка System32 в Проводнике Windows

===== Другие настройки =====

В Настройках Shark Remote вы также можете настроить запуск бота Shark Remote как Службы Windows.

Можно также задать путь для хранения данных и настроек Shark Remote. Для этого создайте рядом с Shark Remote.exe файл storage.txt и запишите в него путь для хранения данных, например: "C:\tools\AppData\Shark Remote"
Указанного пути не должно существовать при первом запуске Shark Remote!

Нажатие и сочетание клавиш в боте

Клавиши

Бот поддерживает следующие клавиши с клавиатуры:

Все клавиши английского алфавита (A-Z)
Все клавиши с цифрами (0-9)
Все F-клавиши (F1-F12)
Клавиши стрелок (UP, LEFT, DOWN, RIGHT)
Мультимедиа клавиши (Play, Pause)
А также клавиши: Win, Ctrl, Alt, Shift, Tab, Esc, Del, Backspace, Print, Space, Insert, End, PageUp, PageDown, CapsLock

Примеры для отправки:
/input 1 K /input 1 Win

Примечание:

Вы можете вводить даже те клавиши, которых у вас нет на физической клавиатуре
Бот автоматически преобразует все клавиши английского алфавита (буквы) в строчные. Для обычного ввода текста используйте /input {t} Мой текст
Бот не отличает сторону расположения одинаковых клавиш (например, левый Alt и правый Alt)

Сочетания клавиш

Сочетания клавиш создаются из кнопок, список которых описан выше. Сочетания клавиш могут включать в себя от 2 до 3 клавиш.

Примеры для отправки:
/input 0 WIN+R
/input 0 CTRL+ALT+DEL

Горячие клавиши приложения

Сtrl + S - включить или выключить бота (для версии 4.6.1 и выше)
Ctrl + M - включить Мини-режим для окна приложения
Ctrl + P - сделать скриншот (всего экрана) и положить его в буфер обмена

Разработка плагинов для бота

Аргументы запуска приложения

Для файла Shark Remote.exe существуют аргументы запуска для активации каких-либо функций.

Пример запуска с аргументом:
Shark Remote.exe --no-window

Доступные аргументы:

--run-sw - принудительно запустить Мастер настройки
--no-window - запуск в свёрнутом виде (только иконка в трее отображается)
--daemon - запуск в режиме демона (Служба Windows)
--skip-sw - выполнить принудительно предварительную настройку бота без запуска Мастера настройки. Запуск:
Shark Remote.exe --skip-sw [токен бота] [username пользователя]