KDEConnect/uk: Difference between revisions

From KDE Wiki Sandbox
(Created page with "За допомогою '''KDE Connect''' ви можете віддавати заздалегідь визначені команди на вашому комп'ютері,...")
(Updating to match new version of source page)
 
(80 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages />
<languages />
== Для чого призначено KDE? ==
== Для чого призначено KDE Connect? ==


'''KDE Connect''' — проєкт, за допомогою якого усі ваші пристрої зможуть обмінюватися даними. Ось лише декілька речей, які уможливлює '''KDE Connect''':
'''KDE Connect''' — проєкт, за допомогою якого усі ваші пристрої зможуть обмінюватися даними. Ось лише декілька речей, які уможливлює '''KDE Connect''':
Line 14: Line 14:
* Переглядати файли на телефоні з вашого комп'ютера
* Переглядати файли на телефоні з вашого комп'ютера
* Керувати гучністю відтворення звуку на комп'ютері за допомогою телефону
* Керувати гучністю відтворення звуку на комп'ютері за допомогою телефону
 
* Надсилати SMS з вашого комп'ютера
 
Незважаючи на поширену думку, ви можете користуватися '''KDE Connect'''у всіх стільничних середовищах. Оскільки більшість розробників програми користуються Плазмою, може так статися, що якоюсь із можливостей не можна скористатися у інших стільничних середовищах. Якщо ви виявили таку можливість, будь ласка, повідомте про це як про ваду. Існує декілька способів зробити користування KDE Connect у середовищах, відмінних від Плазми, зручнішим. Якщо ви користуєтеся GNOME, варто встановити '''GSConnect''', розширення оболонки GNOME. У середовищах із підтримкою AppIndicator (Budgie, Cinnamon, LXDE, Pantheon, Unity), варто встановити indicator-kdeconnect.
 
У поточній версії '''KDE Connect''' передбачено підтримку лише Android і SailfishOS. Розробники '''KDE Connect''' працюють над підтримкою ширшого спектра операційних систем для телефонів (мобільної Плазми, postmarketOS тощо).


== Встановлення ==
== Встановлення ==


Перш ніж користуватися '''KDE Connect''', вам слід встановити програму у вашій системі за допомогою сховищ вашого дистрибутива і вашого телефону.
Найімовірніше, компонент стільниці '''KDE Connect''' у вашому дистрибутиві є пакунком зі сховища пакунків дистрибутива. Якщо це не так, попросіть розробників дистрибутива створити відповідний пакунок.


Ви можете встановити '''KDE Connect''' на вашому комп'ютері за допомогою засобів пошуку '''Discover''' або однієї із таких команд:
Незважаючи на поширену думку, ви можете користуватися '''KDE Connect'''у всіх стільничних середовищах. Оскільки більшість розробників програми користуються Плазмою, може так статися, що якоюсь із можливостей не можна скористатися у інших стільничних середовищах. Якщо ви виявили таку можливість, будь ласка, повідомте про це як про ваду. Існує декілька способів зробити користування KDE Connect у середовищах, відмінних від Плазми, зручнішим. Якщо ви користуєтеся GNOME, варто встановити '''GSConnect''', розширення оболонки GNOME. У середовищах із підтримкою AppIndicator (Budgie, Cinnamon, LXDE, Pantheon, Unity), варто встановити indicator-kdeconnect.


Програму для Android можна знайти у [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Google Play Store] та сховищі вільних і відкритих програм [https://f-droid.org/repository/browse/?fdid=org.kde.kdeconnect_tp F-Droid].


* У Debian, Ubuntu та заснованих на Ubuntu дистрибутивах: sudo apt install kdeconnect
У 2014 році частина розробників працювала над клієнтською версією '''KDE Connect''' для iOS (див. [https://cgit.kde.org/scratch/yangqiao/kdeconnect-ios.git/ початковий код]), яка пару років не розвивалася, знову отримала декілька латок і підтримку TLS у 2018-2019 роках. У 2021 році було започатковано [https://invent.kde.org/lucaswzx/kdeconnect-ios-2021-testing '''основний проєкт'''] з метою оновлення застарілої кодової бази відповідно до новіших бібліотек із можливістю подальшого розширення.
* У Fedora: sudo yum install kdeconnect
* В openSUSE: sudo zypper install kdeconnect
* В Arch та заснованих на Arch дистрибутивах: sudo pacman -S kdeconnect АБО yay -S kdeconnect


Крім того, '''KDE Connect''' можна отримати з  [https://openrepos.net/content/r1tschy/sailfish-connect]. Ми працюємо над тим, щоб програми можна було встановити на інші телефони на основі Linux (Мобільна Плазма, PostmarketOS тощо).


Повніші настанови із поясненнями щодо встановлення програмного забезпечення KDE у вашій системі наведено [[Special:myLanguage/Tutorials/Install_KDE_software|тут]].
[https://kdeconnect.kde.org/download.html Див. сторінку пакунків KDE Connect].


Для встановлення '''KDE Connect''' та телефоні скористайтеся [https://play.google.com/store/apps/details?id=org.kde.kdeconnect_tp Play Store] або [https://f-droid.org/en/packages/org.kde.kdeconnect_tp/ F-Droid].
== Огляд ==


Це сторінка документації до '''KDEConnect'''. Можете також скористатися [https://community.kde.org/KDEConnect сторінкою вікі спільноти], де наведено пояснення щодо призначення та встановлення '''KDEConnect'''.
Для встановлення на '''SailfishOS''' ви можете знайти настанови у [https://openrepos.net/content/piggz/kde-connect сховищі пакунків спільноти].


'''KDE Connect''' складається з двох частин — програми для робочої станції (комп'ютера) та програми для телефону.


==Пов'язування двох пристроїв між собою==
==Пов'язування двох пристроїв між собою==


По-перше, вам слід запустити '''KDE Connect''' на вашому комп'ютері ''і'' телефоні. Після цього на екрані обох пристроїв ви зможете бачити назву пристрою, з яким ви хочете пов'язати інший пристрій. Якщо це так, переконайтеся, що пристрої з'єднано із тією самою мережею, і що не існує брандмауера, який заважає пристроям «бачити» один одного. Докладніше про вирішення проблем можна дізнатися з [https://community.kde.org/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other цієї сторінки у вікі спільноти].  
По-перше, вам слід запустити '''KDE Connect''' на вашому комп'ютері ''і'' телефоні. Після цього на екрані обох пристроїв ви зможете бачити назву пристрою, з яким ви хочете пов'язати інший пристрій. Якщо це так, переконайтеся, що пристрої з'єднано із тією самою мережею, і що не існує брандмауера, який заважає пристроям «бачити» один одного. Докладніше про вирішення проблем можна дізнатися з [Special:myLanguage/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other|розділу щодо вад].


[[File:KDE_Connect_computer_sync.png|4000px|center]]
[[File:KDE_Connect_computer_sync.png|4000px|center]]
Line 53: Line 48:
Хоча у типовому випадку пов'язується комп'ютер із телефоном, ви також можете пов'язати між собою два комп'ютери.
Хоча у типовому випадку пов'язується комп'ютер із телефоном, ви також можете пов'язати між собою два комп'ютери.


{{Construction}}
== Інтеграція із браузером ==
 
[https://community.kde.org/Plasma/Browser_Integration Інтеграція з браузером у Плазмі] робить '''KDE Connect''' ще потужнішим. За її допомогою ви можете керувати відтворенням даних, наприклад, на Youtube або Netflix з телефону або надсилати адреси вкладок браузера на телефон. Незважаючи на назву, програмами для інтеграції можна користуватися і у середовищах, відмінних від Плазми.
 
== Зміна назв пристроїв ==
 
Змінити назву пристрою можна лише на самому пристрої. Отже, якщо вам хочеться змінити назву вашого комп'ютера, вам доведеться скористатися програмою на цьому комп'ютері. Якщо ви хочете змінити назву вашого телефону або планшета, вам слід внести зміни за допомогою програми '''KDE Connect'''. Після перейменування назва пристрою має автоматично оновитися на інших з'єднаних з ним пристроях.
 
[[File:KDEConnectRename.png|1000px|center]]
 
== Робота KDE Connect з OpenVPN ==
 
У користування '''KDE Connect''' з VPN може бути декілька причин. Наприклад, у вас може виникнути потреба віддати команду домашній системі віддалено, ви можете працювати у відкритій мережі wifi, де ваші пристрої не можуть обмінюватися даними, або ви хочете скористатися пристроєм дистанційного керування для презентації.
 
=== Налаштовування OpenVPN ===
 
Якщо у вас є власний сервер із загальнодоступною  IP-адресою, ви можете налаштувати '''OpenVPN''' власноруч. Налаштувати це програмне забезпечення непросто, але його можна виконати за [https://openvpn.net/howto.html такими настановами].
 
Щоб уможливити передавання даних трансляційними пакетами UDP, які '''KDE Connect''' використовує для автоматичного виявлення двох пристроїв, '''OpenVPN''' має бути налаштовано для роботи з містками (пристрій TAP). Якщо ви користуєтеся tun, ви можете встановити з'єднання вручну за IP-адресою.
 
Якщо ви хочете скористатися орендованою попередньо налаштованою службою '''OpenVPN''', а не налаштовувати власну, усе має спрацювати, але слід зважати на ті самі вимоги щодо параметрів сервера.


== Огляд ==
Щойно сервер запрацює, ви можете скорситатися офіційним клієнтом '''OpenVPN''' для з'єднання вашого комп'ютера із сервером. Офіційних клієнтів '''OpenVPN''' для Android не існує, але відомо, що добре працює клієнт '''OpenVPN for Android''': [https://play.google.com/store/apps/details?id=de.blinkt.openvpn openvpn]


Це сторінка документації до '''KDEConnect'''. Можете також скористатися [https://community.kde.org/KDEConnect сторінкою вікі спільноти], де наведено пояснення щодо призначення та встановлення '''KDEConnect'''.
Щойно два пристрої буде з'єднано, перевірте, чи можуть вони обмінюватися даними за допомогою VPN, скориставшись надсиланням між ними луна-сигналу.


'''KDE Connect''' складається з двох частин — програми для робочої станції (комп'ютера) та програми для телефону.
=== Налаштовування KDE Connect ===


== Зміна назв пристроїв ==
Якщо ваш екземпляр '''OpenVPN''' налаштовано на роботу з містками, '''KDE Connect''' має працювати так, як він працює у локальній мережі.


Змінити назву пристрою можна лише на самому пристрої. Отже, якщо вам хочеться змінити назву вашого комп'ютера, вам доведеться скористатися програмою на цьому комп'ютері. Якщо ви хочете змінити назву вашого телефону або планшета, вам слід внести зміни за допомогою програми '''KDE Connect'''. Після перейменування назва пристрою має автоматично оновитися на інших з'єднаних з ним пристроях.
Якщо ви користуєтеся '''OpenVPN''' із тунельованим пристроєм (tun), вам доведеться додавати ваші пристрої вручну за IP-адресою. Далі, щойно буде встановлено з'єднання із VPN, '''KDE Connect''' має автоматично виявити ваш пристрій і або встановити з'єднання, або бути готовим до прив'язування!


==Доступні додатки ==
==Доступні додатки ==
Line 70: Line 85:


Показ рівня заряду в акумуляторі телефону поряд із рівнем заряду акумулятора комп'ютера.
Показ рівня заряду в акумуляторі телефону поряд із рівнем заряду акумулятора комп'ютера.
Якщо увімкнено цей додаток, віджет '''KDE Connect''' у лотку панелі стільниці вашого комп'ютера показуватиме рівень заряду акумулятора телефону.
[[File:KDEConnectBattery.png|500px|center]]


===Буфер обміну даними===
===Буфер обміну даними===


''Спільне використання буфера обміну даними на різних пристроях.''
''Спільне використання буфера обміну даними на різних пристроях.''
За допомогою цього додатка ви можете просто скопіювати текст на вашому комп'ютері і негайно отримати до нього доступ на вашому телефоні, і навпаки. Втім, цей спосіб копіювання не працює для зображень.
====Автоматична синхронізація на Android 10+====
Android 10 запобігає доступу з боку програм до буфера обміну даними для запобігання доступу до цих даних з боку програм зловмисників. Це робити користування додатком буфера обміну даними у KDE Connect некомфортним.
=====Модуль Magisk (лише root)=====
Якщо систему рутовано, ви можете скористатися модулем Magisk для вилучення цього обмеження.
=====Читання журналу=====
Якщо у вас є збірка, що містить внесок [https://invent.kde.org/network/kdeconnect-android/commit/edc655da5ac1eb5c3027c8556cc62037a1d4c5ac edc655da5ac1eb5c3027c8556cc62037a1d4c5ac], ви можете увімкнути права доступу READ_LOGS з метою увімкнути обхідний код для синхронізації буфера обміну даними.
Віддайте такі команди:
<syntaxhighlight lang="bash">
adb -d shell pm grant org.kde.kdeconnect_tp android.permission.READ_LOGS;
adb -d shell appops set org.kde.kdeconnect_tp SYSTEM_ALERT_WINDOW allow;
adb -d shell am force-stop org.kde.kdeconnect_tp;
</syntaxhighlight>
''Як це працює?''
Якщо увімкнено читання журналу, KDE Connect спостерігатиме за власним журналом. Якщо програмою буде виявлено, що їй заборонено доступ до читання даних з буфера обміну даними, вона відкриє невидиме вікно у передньому плані, захопить буфер обміну даними і закриє вікно.
===Контакти===
''"Синхронізувати контакти між пристроями"''
Цей додаток без повідомлень синхронізує контакти, у форматі vcard, з вашого телефону з вашою робочою станцією.
На час написання цього синхронізація є однобічною — дані надсилатимуться з реалізації Android на робочу станцію, ними зможе скористатися будь-яка програм, яка використовує бібліотеку KPeople з додатком KPeopleVCard, зокрема програма для роботи з SMS KDE Connect.
====Розташування VCard====
На платформах, відмінних від Windows, картки контактів буде записано до ''QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) + "/kpeoplevcard"''. Місце може бути налаштовано на інше місце вашою системою, але, зазвичай, це ''~/.local/share/kpeoplevcard''.
У Windows шлях буде перетворено на ''%LocalAppData%''.


===Успадкування зберігача екрана===
===Успадкування зберігача екрана===
Line 114: Line 170:


За допомогою цього додатка ви можете отримати доступ до сховища даних вашого телефону! Якщо додаток увімкнено, пункт пристрою з'явиться у Dolphin і ви зможете здійснювати навігацію зовнішніми та внутрішніми сховищами даних.
За допомогою цього додатка ви можете отримати доступ до сховища даних вашого телефону! Якщо додаток увімкнено, пункт пристрою з'явиться у Dolphin і ви зможете здійснювати навігацію зовнішніми та внутрішніми сховищами даних.
[[File:KDEConnectBrowse.png|1000px|center]]
[[File:KDEConnectViewBrowser.png|500px|center]]


===Дзвінок на вашому телефоні===
===Дзвінок на вашому телефоні===


Цим додатком можна також скористатися для перевірки з'єднання із вказаним пристроєм. Ініціювавши дзвінок на вашому телефоні віддалено, ви можете швидко знайти його!
Цим додатком можна також скористатися для перевірки з'єднання із вказаним пристроєм. Ініціювавши дзвінок на вашому телефоні віддалено, ви можете швидко знайти його!
[[File:KDEConnectRing.png|500px|center]]


===Запуск команд===
===Запуск команд===


За допомогою '''KDE Connect''' ви можете віддавати заздалегідь визначені команди на вашому комп'ютері, натискаючи кнопки вашого телефону!
За допомогою '''KDE Connect''' ви можете віддавати заздалегідь визначені команди на вашому комп'ютері, натискаючи кнопки вашого телефону!
Настанови щодо додавання команд наведено на [[Special:myLanguage/KDE_Connect/Tutorials/Adding_commands|userbase]]. Набір корисних команд наведено [[Special:myLanguage/KDE_Connect/Tutorials/Useful_commands|тут]].
Настанови щодо додавання команд наведено на [[Special:myLanguage/KDE_Connect/Tutorials/Adding_commands|userbase]]. Набір корисних команд наведено [[Special:myLanguage/KDE_Connect/Tutorials/Useful_commands|тут]].  


===Надсилання сповіщень===
===Надсилання сповіщень===


This keeps you in touch with what happens on your computer! Any notifications you receive on your computer will be shown in your phone.
Тут усе очевидно: сповіщення з вашого комп'ютера буде показано на вашому телефоні.
 
Цей додаток надасть вам змогу стежити за подіями на вашому комп'ютері! Усі сповіщення, які ви отримуватимете на вашому комп'ютері, буде показано на вашому телефоні.


===Спільне використання та отримання даних===
===Спільне використання та отримання даних===
Цей додаток забезпечує інтеграцію вашого комп'ютера і програми для перегляду файлів із телефоном: ви зможете клацнути правою кнопкою миші на файлі або посиланні і надіслати його безпосередньо на ваш телефон!
Для файлів у контекстному меню буде показано пункт «Надіслати на телефон за допомогою KDEConnect», за допомогою якого файл можна надіслати на телефон безпосередньо. Процес надсилання буде завершено показом сповіщення.
Для посилань у контекстному меню буде показано пункт «Відкрити на телефоні», за допомогою якого можна буде автоматично відкрити посилання у типовому браузері телефону. Доволі зручно!


тут має бути пояснення
тут має бути пояснення
Line 137: Line 207:


===Віртуальне введення===
===Віртуальне введення===
Якщо увімкнено цей додаток, увімкнувши на вашому телефоні віддалене введення, ви можете перетворити його сенсорний екран та сенсорну панель керування вашим комп'ютером. Одинарне торкання екрана буде еквівалентне до одинарного клацання кнопкою миші.
За допомогою піктограми клавіатури у верхньому правому куті екрана ви зможете вводити дані на телефоні і передавати їх на ваш комп'ютер.


тут має бути пояснення
тут має бути пояснення
===Керування презентаціями===
Можна керувати презентаціями за допомогою кнопки «Попередній/Наступний слайд». Якщо пристрій заблоковано, ви можете користуватися для цього кнопками збільшення або зменшення гучності. Ви також можете підсвічувати щось за допомогою лазерної указки. Просто пересувайте ваш телефон, і синє коло пересуватиметься разом із ним! За допомогою кнопки меню із трьома горизонтальними смужками ви можете перемикати повноекранний режим (F5) або виходити з режиму презентації (Esc).
== Пояснення щодо прав доступу та відеопідручники ==
Час від часу, Google вимагатиме підтвердження того, що під час вивантаження відео ми використовуємо права доступу у спосіб, який дозволено правилами Play Store. Ці відео зібрано тут з довідковою метою, а також з метою забезпечення вас покроковими настановами щодо того, як користуватися певними можливостями. Ці відео також корисні, як демонстрація використання прав доступу ширшій аудиторії.
=== Отримувач подій миші Android (права доступу доступності) ===
Щоб мати змогу імітувати пристрій введення даних, Android потребує прав доступу доступності. Роботу додатка отримання подій миші продемонстровано у наведеному нижче відео.
{{#ev:youtube|PQ-Oubt4Rks}}
=== Інші права доступу ===
У цьому відео продемонстровано декілька можливостей KDE Connect. Зокрема, продемонстровано, як KDE Connect використовує права, які порушують конфіденційності, зокрема права доступу на надсилання SMS.
{{#ev:youtube|QGHzXpX0vtk}}
== Усування вад ==
<span id="I have two devices running KDE Connect on the same network, but they can't see each other"></span>
=== Маємо два пристрої із запущеним KDE Connect в одній мережі, але вони не бачать один одного ===
'''KDE Connect''' використовує динамічні порти у діапазоні 1714-1764 для UDP і TCP. Тому, якщо ви працюєте за брандмауером, не забудьте відкрити цей діапазон портів для TCP і UDP. Якщо це не так, переконайтеся, що ваша мережа не блокує трансляційні пакети UDP.
Перевірка того, що процес очікує на дані з мережі:
<syntaxhighlight lang="bash">
sudo netstat -tunelp | grep -i kdeconnect
</syntaxhighlight>
Порти відкрито/заблоковано?
<syntaxhighlight lang="bash">
netcat -z -v <your-phones-ip> 1714-1764
</syntaxhighlight>
Приклад виведення:
Connection to <ip-адреса вашого телефону> 1716 port [tcp/*] succeeded!
Ви також отримаєте багато повідомлень у відмові щодо з'єднання, але вам потрібне лише одне повідомлення з “succeeded”
If the the network connection is not the problem, you might try starting from a clean configuration again:
<syntaxhighlight lang="bash">
killall kdeconnectd
mv ~/.config/kdeconnect ~/.config/kdeconnect.bak
</syntaxhighlight>
==== ufw ====
Якщо ви користуєтеся брандмауером '''ufw''', відкрити потрібні порти можна за допомогою такої команди:
<syntaxhighlight lang="bash">
sudo ufw allow 1714:1764/udp
sudo ufw allow 1714:1764/tcp
sudo ufw reload
</syntaxhighlight>
==== firewalld ====
Якщо ви користуєтеся брандмауером '''firewalld''', відкрити потрібні порти можна такими командами:
<syntaxhighlight lang="bash">
sudo firewall-cmd --permanent --zone=public --add-service=kdeconnect
sudo firewall-cmd --reload
</syntaxhighlight>
==== Налаштовування брандмауера (firewall-config) ====
Відкрийте «Налаштування брандмауера» (назва файла програми — <code>firewall-config</code>) і на сторінці '''Зони''' ➔ '''Служби''' позначте службу kde-connect.
Переконайтеся, що у верхньому спадному списку вибрано '''Сталі (Permanent)''' налаштування. Якщо ви цього не зробите, параметри буде скинуто під час перезавантаження системи.
==== iptables ====
Якщо ви користуєтеся брандмауером '''iptables''', відкрити потрібні порти можна такими командами:
<syntaxhighlight lang="bash">
sudo iptables -I INPUT -i <yourinterface> -p udp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -I INPUT -i <yourinterface> -p tcp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o <yourinterface> -p udp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o <yourinterface> -p tcp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
</syntaxhighlight>
===  KDE Connect аварійно завершує роботу або перезапускається при спробі встановлення зв'язку із іншим пристроєм ===
Іноді, пошкоджений файл налаштувань може призвести до того, що '''KDE Connect''' аварійно завершує роботу при спробі встановити зв'язок із пристроєм. У цьому випадку, може допомогти вилучення файла налаштувань <tt>~/.config/kdeconnect</tt>.
=== Програма KDE Connect для Android аварійно завершує роботу ===
Якщо програма KDE Connect для Android завершує роботу в аварійному режимі, ви можете отримати додаткові відомості щодо аварії за допомогою команди '''adb logcat'''.
Налаштуйте ADB за допомогою [https://developer.android.com/studio/command-line/adb офіційних настанов]
Вказана нижче команда має вивести список усіх відомостей, які пов'язано із аварією. Запустіть '''adb logcat''' *до* того, як спробуєте відтворити аварію.
<syntaxhighlight lang="bash">
adb logcat --pid=$(adb shell pidof -s org.kde.kdeconnect_tp)
</syntaxhighlight>
===  Чи можна користуватися KDE Connect без графічного сервера? ===
Так, ви можете передати аргумент командного рядка до фонової служби (приклад: <code>killall -9 kdeconnectd; /usr/lib/libexec/kdeconnectd -platform offscreen</code>)
=== GSConnect ===
'''GSConnect''' є незалежним проєктом, який реалізує протокол '''KDE Connect''' у GNOME і використовує ту саму програму для Android. Якщо ви працюєте з '''GSConnect''', будь ласка, спочатку відвідайте [https://github.com/andyholmes/gnome-shell-extension-gsconnect/wiki сторінку GitHub проєкту], щоб дізнатися про адреси підтримки. Якщо вами і командою '''GSConnect''' буде визначено, що проблеми пов'язано із програмою для Android або протоколом, будь ласка, повідомте про цю ваду за допомогою системи стеження за вадами '''KDE Connect'''.
===  Вашої проблеми немає у цьому списку :( ===
Якщо вами виявлено ваду у програмі, і ви хочете повідомити нам про неї, скористайтеся [https://bugs.kde.org/enter_bug.cgi?product=kdeconnect системою стеження за вадами KDE].

Latest revision as of 08:48, 26 January 2023

Other languages:

Для чого призначено KDE Connect?

KDE Connect — проєкт, за допомогою якого усі ваші пристрої зможуть обмінюватися даними. Ось лише декілька речей, які уможливлює KDE Connect:


  • Отримання сповіщень з телефону на вашому робочому комп'ютері та можливість відповідати на повідомлення з комп'ютера
  • Керування відтворенням музики на вашому комп'ютері з телефону
  • Використання телефону як пульту дистанційного керування комп'ютером
  • Запускати попередньо визначені програми на вашому комп'ютері за допомогою з'єднаних із комп'ютером пристроїв. Див. список прикладів програм-команд, щоб дізнатися про це більше.
  • Бачити рівень заряду акумулятора вашого телефону на вашому комп'ютері
  • Наказати вашому телефону задзвонити, щоб його було простіше знайти
  • Спільно використовувати файли і посилання на усіх ваших пристроях
  • Переглядати файли на телефоні з вашого комп'ютера
  • Керувати гучністю відтворення звуку на комп'ютері за допомогою телефону
  • Надсилати SMS з вашого комп'ютера

Встановлення

Найімовірніше, компонент стільниці KDE Connect у вашому дистрибутиві є пакунком зі сховища пакунків дистрибутива. Якщо це не так, попросіть розробників дистрибутива створити відповідний пакунок.

Незважаючи на поширену думку, ви можете користуватися KDE Connectу всіх стільничних середовищах. Оскільки більшість розробників програми користуються Плазмою, може так статися, що якоюсь із можливостей не можна скористатися у інших стільничних середовищах. Якщо ви виявили таку можливість, будь ласка, повідомте про це як про ваду. Існує декілька способів зробити користування KDE Connect у середовищах, відмінних від Плазми, зручнішим. Якщо ви користуєтеся GNOME, варто встановити GSConnect, розширення оболонки GNOME. У середовищах із підтримкою AppIndicator (Budgie, Cinnamon, LXDE, Pantheon, Unity), варто встановити indicator-kdeconnect.

Програму для Android можна знайти у Google Play Store та сховищі вільних і відкритих програм F-Droid.

У 2014 році частина розробників працювала над клієнтською версією KDE Connect для iOS (див. початковий код), яка пару років не розвивалася, знову отримала декілька латок і підтримку TLS у 2018-2019 роках. У 2021 році було започатковано основний проєкт з метою оновлення застарілої кодової бази відповідно до новіших бібліотек із можливістю подальшого розширення.

Крім того, KDE Connect можна отримати з [1]. Ми працюємо над тим, щоб програми можна було встановити на інші телефони на основі Linux (Мобільна Плазма, PostmarketOS тощо).

Див. сторінку пакунків KDE Connect.

Огляд

Це сторінка документації до KDEConnect. Можете також скористатися сторінкою вікі спільноти, де наведено пояснення щодо призначення та встановлення KDEConnect.

KDE Connect складається з двох частин — програми для робочої станції (комп'ютера) та програми для телефону.

Пов'язування двох пристроїв між собою

По-перше, вам слід запустити KDE Connect на вашому комп'ютері і телефоні. Після цього на екрані обох пристроїв ви зможете бачити назву пристрою, з яким ви хочете пов'язати інший пристрій. Якщо це так, переконайтеся, що пристрої з'єднано із тією самою мережею, і що не існує брандмауера, який заважає пристроям «бачити» один одного. Докладніше про вирішення проблем можна дізнатися з [Special:myLanguage/KDEConnect#I_have_two_devices_running_KDE_Connect_on_the_same_network.2C_but_they_can.27t_see_each_other|розділу щодо вад].

Тепер можна надіслати запит щодо пов'язування пристроїв на одному з пристроїв. На іншому пристрої з'явиться запит щодо підтвердження запиту з пов'язування. Підтвердіть дію. І усе! Тепер ваші пристрої пов'язано.

Хоча у типовому випадку пов'язується комп'ютер із телефоном, ви також можете пов'язати між собою два комп'ютери.

Інтеграція із браузером

Інтеграція з браузером у Плазмі робить KDE Connect ще потужнішим. За її допомогою ви можете керувати відтворенням даних, наприклад, на Youtube або Netflix з телефону або надсилати адреси вкладок браузера на телефон. Незважаючи на назву, програмами для інтеграції можна користуватися і у середовищах, відмінних від Плазми.

Зміна назв пристроїв

Змінити назву пристрою можна лише на самому пристрої. Отже, якщо вам хочеться змінити назву вашого комп'ютера, вам доведеться скористатися програмою на цьому комп'ютері. Якщо ви хочете змінити назву вашого телефону або планшета, вам слід внести зміни за допомогою програми KDE Connect. Після перейменування назва пристрою має автоматично оновитися на інших з'єднаних з ним пристроях.

Робота KDE Connect з OpenVPN

У користування KDE Connect з VPN може бути декілька причин. Наприклад, у вас може виникнути потреба віддати команду домашній системі віддалено, ви можете працювати у відкритій мережі wifi, де ваші пристрої не можуть обмінюватися даними, або ви хочете скористатися пристроєм дистанційного керування для презентації.

Налаштовування OpenVPN

Якщо у вас є власний сервер із загальнодоступною IP-адресою, ви можете налаштувати OpenVPN власноруч. Налаштувати це програмне забезпечення непросто, але його можна виконати за такими настановами.

Щоб уможливити передавання даних трансляційними пакетами UDP, які KDE Connect використовує для автоматичного виявлення двох пристроїв, OpenVPN має бути налаштовано для роботи з містками (пристрій TAP). Якщо ви користуєтеся tun, ви можете встановити з'єднання вручну за IP-адресою.

Якщо ви хочете скористатися орендованою попередньо налаштованою службою OpenVPN, а не налаштовувати власну, усе має спрацювати, але слід зважати на ті самі вимоги щодо параметрів сервера.

Щойно сервер запрацює, ви можете скорситатися офіційним клієнтом OpenVPN для з'єднання вашого комп'ютера із сервером. Офіційних клієнтів OpenVPN для Android не існує, але відомо, що добре працює клієнт OpenVPN for Android: openvpn

Щойно два пристрої буде з'єднано, перевірте, чи можуть вони обмінюватися даними за допомогою VPN, скориставшись надсиланням між ними луна-сигналу.

Налаштовування KDE Connect

Якщо ваш екземпляр OpenVPN налаштовано на роботу з містками, KDE Connect має працювати так, як він працює у локальній мережі.

Якщо ви користуєтеся OpenVPN із тунельованим пристроєм (tun), вам доведеться додавати ваші пристрої вручну за IP-адресою. Далі, щойно буде встановлено з'єднання із VPN, KDE Connect має автоматично виявити ваш пристрій і або встановити з'єднання, або бути готовим до прив'язування!

Доступні додатки

Стеження за акумулятором

Показ рівня заряду в акумуляторі телефону поряд із рівнем заряду акумулятора комп'ютера.

Якщо увімкнено цей додаток, віджет KDE Connect у лотку панелі стільниці вашого комп'ютера показуватиме рівень заряду акумулятора телефону.

Буфер обміну даними

Спільне використання буфера обміну даними на різних пристроях.

За допомогою цього додатка ви можете просто скопіювати текст на вашому комп'ютері і негайно отримати до нього доступ на вашому телефоні, і навпаки. Втім, цей спосіб копіювання не працює для зображень.

Автоматична синхронізація на Android 10+

Android 10 запобігає доступу з боку програм до буфера обміну даними для запобігання доступу до цих даних з боку програм зловмисників. Це робити користування додатком буфера обміну даними у KDE Connect некомфортним.

Модуль Magisk (лише root)

Якщо систему рутовано, ви можете скористатися модулем Magisk для вилучення цього обмеження.

Читання журналу

Якщо у вас є збірка, що містить внесок edc655da5ac1eb5c3027c8556cc62037a1d4c5ac, ви можете увімкнути права доступу READ_LOGS з метою увімкнути обхідний код для синхронізації буфера обміну даними.

Віддайте такі команди:

adb -d shell pm grant org.kde.kdeconnect_tp android.permission.READ_LOGS;
adb -d shell appops set org.kde.kdeconnect_tp SYSTEM_ALERT_WINDOW allow;
adb -d shell am force-stop org.kde.kdeconnect_tp;

Як це працює?

Якщо увімкнено читання журналу, KDE Connect спостерігатиме за власним журналом. Якщо програмою буде виявлено, що їй заборонено доступ до читання даних з буфера обміну даними, вона відкриє невидиме вікно у передньому плані, захопить буфер обміну даними і закриє вікно.

Контакти

"Синхронізувати контакти між пристроями"

Цей додаток без повідомлень синхронізує контакти, у форматі vcard, з вашого телефону з вашою робочою станцією.

На час написання цього синхронізація є однобічною — дані надсилатимуться з реалізації Android на робочу станцію, ними зможе скористатися будь-яка програм, яка використовує бібліотеку KPeople з додатком KPeopleVCard, зокрема програма для роботи з SMS KDE Connect.

Розташування VCard

На платформах, відмінних від Windows, картки контактів буде записано до QStandardPaths::writableLocation(QStandardPaths::GenericDataLocation) + "/kpeoplevcard". Місце може бути налаштовано на інше місце вашою системою, але, зазвичай, це ~/.local/share/kpeoplevcard.

У Windows шлях буде перетворено на %LocalAppData%.

Успадкування зберігача екрана

Успадкування зберігача екрана, коли пристрій з'єднано із комп'ютером.

Цей додаток забезпечує незапуск вашого зберігача екрана, доки пристрій з'єднано із комп'ютером.

Приймач для керування відтворенням мультимедійних даних

За допомогою цієї можливості ви можете віддалено керувати відтворенням вашої музики або відео: призупиняти і поновлювати відтворення, переходити до наступної або попередньої композиції, пересувати позицію відтворення на 5 секунд вперед або назад. Ви також можете вказати програму для відтворення мультимедійних даних, якою ви керуватимете, а також визначити керування гучністю у програмі або у всій системі.

Керування відтворенням мультимедійних даних за допомогою KDE Connect в Android
Керування відтворенням мультимедійних даних за допомогою KDE Connect в Android

Призупинення відтворення мультимедійних даних під час дзвінків

Призупинення відтворення музики або відео під час дзвінків. Потужна можливість у поєднанні із інтеграцією Плазми із браузером. Наприклад, якщо ви дивитеся якесь відео на Youtube, відтворення буде призупинено, якщо вам хтось зателефонує.

Ви можете налаштувати програму так, щоб відтворення призупинялося, коли ви приймаєте дзвінок або у момент, коли ваш телефон починає дзвонити. Ви також можете визначити, слід лише призупинити відтворення звуку чи/або взагалі вимкнути звук у системі.

Луна

Надсилання і отримання сигналів.

Цей додаток призначено для перевірок з'єднання із вказаним пристроєм. Якщо вибрати його пункт на пристрої, який має отримати сигнал, з'явиться повідомлення «Пінг!».

На вашому комп'ютері ви можете надіслати луна-сигнал за допомогою параметрів KDE Connect або віджета у системному лотку.

На вашому телефоні ви можете надіслати луна-сигнал за допомогою верхнього меню з трьома рисками у програмі KDE Connect.

Надсилання луна-сигналу на ваш комп'ютер у системі android
Надсилання луна-сигналу на ваш комп'ютер у системі android

Отримання сповіщень

Показ сповіщень з телефону на вашому комп'ютері та підтримання синхронізації сповіщень.

Цей додаток надасть вам змогу стежити за подіями на вашому телефоні! Будь-які отримані вами сповіщення на вашому телефоні буде показано на вашому комп'ютері. На деякі сповіщень, зокрема на сповіщення від систем миттєвого обміну повідомленнями, зокрема Telegram, можна одразу відповісти за допомогою самої панелі сповіщення на комп'ютері.

Навігатор віддаленою файловою системою

За допомогою цього додатка ви можете отримати доступ до сховища даних вашого телефону! Якщо додаток увімкнено, пункт пристрою з'явиться у Dolphin і ви зможете здійснювати навігацію зовнішніми та внутрішніми сховищами даних.

Дзвінок на вашому телефоні

Цим додатком можна також скористатися для перевірки з'єднання із вказаним пристроєм. Ініціювавши дзвінок на вашому телефоні віддалено, ви можете швидко знайти його!

Запуск команд

За допомогою KDE Connect ви можете віддавати заздалегідь визначені команди на вашому комп'ютері, натискаючи кнопки вашого телефону! Настанови щодо додавання команд наведено на userbase. Набір корисних команд наведено тут.

Надсилання сповіщень

Тут усе очевидно: сповіщення з вашого комп'ютера буде показано на вашому телефоні.

Цей додаток надасть вам змогу стежити за подіями на вашому комп'ютері! Усі сповіщення, які ви отримуватимете на вашому комп'ютері, буде показано на вашому телефоні.

Спільне використання та отримання даних

Цей додаток забезпечує інтеграцію вашого комп'ютера і програми для перегляду файлів із телефоном: ви зможете клацнути правою кнопкою миші на файлі або посиланні і надіслати його безпосередньо на ваш телефон!

Для файлів у контекстному меню буде показано пункт «Надіслати на телефон за допомогою KDEConnect», за допомогою якого файл можна надіслати на телефон безпосередньо. Процес надсилання буде завершено показом сповіщення.

Для посилань у контекстному меню буде показано пункт «Відкрити на телефоні», за допомогою якого можна буде автоматично відкрити посилання у типовому браузері телефону. Доволі зручно!

тут має бути пояснення

Інтеграція з телефоном

тут має бути пояснення

Віртуальне введення

Якщо увімкнено цей додаток, увімкнувши на вашому телефоні віддалене введення, ви можете перетворити його сенсорний екран та сенсорну панель керування вашим комп'ютером. Одинарне торкання екрана буде еквівалентне до одинарного клацання кнопкою миші.

За допомогою піктограми клавіатури у верхньому правому куті екрана ви зможете вводити дані на телефоні і передавати їх на ваш комп'ютер.

тут має бути пояснення

Керування презентаціями

Можна керувати презентаціями за допомогою кнопки «Попередній/Наступний слайд». Якщо пристрій заблоковано, ви можете користуватися для цього кнопками збільшення або зменшення гучності. Ви також можете підсвічувати щось за допомогою лазерної указки. Просто пересувайте ваш телефон, і синє коло пересуватиметься разом із ним! За допомогою кнопки меню із трьома горизонтальними смужками ви можете перемикати повноекранний режим (F5) або виходити з режиму презентації (Esc).

Пояснення щодо прав доступу та відеопідручники

Час від часу, Google вимагатиме підтвердження того, що під час вивантаження відео ми використовуємо права доступу у спосіб, який дозволено правилами Play Store. Ці відео зібрано тут з довідковою метою, а також з метою забезпечення вас покроковими настановами щодо того, як користуватися певними можливостями. Ці відео також корисні, як демонстрація використання прав доступу ширшій аудиторії.

Отримувач подій миші Android (права доступу доступності)

Щоб мати змогу імітувати пристрій введення даних, Android потребує прав доступу доступності. Роботу додатка отримання подій миші продемонстровано у наведеному нижче відео. {{#ev:youtube|PQ-Oubt4Rks}}

Інші права доступу

У цьому відео продемонстровано декілька можливостей KDE Connect. Зокрема, продемонстровано, як KDE Connect використовує права, які порушують конфіденційності, зокрема права доступу на надсилання SMS. {{#ev:youtube|QGHzXpX0vtk}}

Усування вад

Маємо два пристрої із запущеним KDE Connect в одній мережі, але вони не бачать один одного

KDE Connect використовує динамічні порти у діапазоні 1714-1764 для UDP і TCP. Тому, якщо ви працюєте за брандмауером, не забудьте відкрити цей діапазон портів для TCP і UDP. Якщо це не так, переконайтеся, що ваша мережа не блокує трансляційні пакети UDP.

Перевірка того, що процес очікує на дані з мережі:

sudo netstat -tunelp | grep -i kdeconnect

Порти відкрито/заблоковано?

netcat -z -v <your-phones-ip> 1714-1764

Приклад виведення:

Connection to <ip-адреса вашого телефону> 1716 port [tcp/*] succeeded!

Ви також отримаєте багато повідомлень у відмові щодо з'єднання, але вам потрібне лише одне повідомлення з “succeeded”

If the the network connection is not the problem, you might try starting from a clean configuration again:

killall kdeconnectd
mv ~/.config/kdeconnect ~/.config/kdeconnect.bak

ufw

Якщо ви користуєтеся брандмауером ufw, відкрити потрібні порти можна за допомогою такої команди:

sudo ufw allow 1714:1764/udp
sudo ufw allow 1714:1764/tcp
sudo ufw reload

firewalld

Якщо ви користуєтеся брандмауером firewalld, відкрити потрібні порти можна такими командами:

sudo firewall-cmd --permanent --zone=public --add-service=kdeconnect
sudo firewall-cmd --reload

Налаштовування брандмауера (firewall-config)

Відкрийте «Налаштування брандмауера» (назва файла програми — firewall-config) і на сторінці ЗониСлужби позначте службу kde-connect.

Переконайтеся, що у верхньому спадному списку вибрано Сталі (Permanent) налаштування. Якщо ви цього не зробите, параметри буде скинуто під час перезавантаження системи.

iptables

Якщо ви користуєтеся брандмауером iptables, відкрити потрібні порти можна такими командами:

sudo iptables -I INPUT -i <yourinterface> -p udp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -I INPUT -i <yourinterface> -p tcp --dport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT

sudo iptables -A OUTPUT -o <yourinterface> -p udp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A OUTPUT -o <yourinterface> -p tcp --sport 1714:1764 -m state --state NEW,ESTABLISHED -j ACCEPT

KDE Connect аварійно завершує роботу або перезапускається при спробі встановлення зв'язку із іншим пристроєм

Іноді, пошкоджений файл налаштувань може призвести до того, що KDE Connect аварійно завершує роботу при спробі встановити зв'язок із пристроєм. У цьому випадку, може допомогти вилучення файла налаштувань ~/.config/kdeconnect.

Програма KDE Connect для Android аварійно завершує роботу

Якщо програма KDE Connect для Android завершує роботу в аварійному режимі, ви можете отримати додаткові відомості щодо аварії за допомогою команди adb logcat.

Налаштуйте ADB за допомогою офіційних настанов

Вказана нижче команда має вивести список усіх відомостей, які пов'язано із аварією. Запустіть adb logcat *до* того, як спробуєте відтворити аварію.

adb logcat --pid=$(adb shell pidof -s org.kde.kdeconnect_tp)

Чи можна користуватися KDE Connect без графічного сервера?

Так, ви можете передати аргумент командного рядка до фонової служби (приклад: killall -9 kdeconnectd; /usr/lib/libexec/kdeconnectd -platform offscreen)

GSConnect

GSConnect є незалежним проєктом, який реалізує протокол KDE Connect у GNOME і використовує ту саму програму для Android. Якщо ви працюєте з GSConnect, будь ласка, спочатку відвідайте сторінку GitHub проєкту, щоб дізнатися про адреси підтримки. Якщо вами і командою GSConnect буде визначено, що проблеми пов'язано із програмою для Android або протоколом, будь ласка, повідомте про цю ваду за допомогою системи стеження за вадами KDE Connect.

Вашої проблеми немає у цьому списку :(

Якщо вами виявлено ваду у програмі, і ви хочете повідомити нам про неї, скористайтеся системою стеження за вадами KDE.