Skip to content

Releases

XDesk v0.6.0-beta.5

XDesk v0.6.0-beta.5 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 10:14

XDesk 0.6.0 beta 5

中文说明见下方

A beta for the Linux side: Termux alone is now enough, the xdesk command keeps itself in step with the app, and a program that does not open says why. It installs over beta 4 and the betas before it, or over 0.5.1, which stays the latest stable release. Everything in beta 2 to beta 4 still applies.

Run the installer again in Termux after installing the APK. The new app needs the new xdesk command; from now on the app offers to update it by itself:
curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | XDESK_VERSION=v0.6.0-beta.5 bash

New: Termux alone is enough

  • No desktop needed. The installer adds a window manager (xfwm4), and the programs you install (pkg install firefox, or inside a proot container) open one by one on the display.
  • Every proot-distro container is an environment of its own, with or without a desktop.
  • Containers and desktops you install later show up in XDesk by themselves; no more xdesk setup. A container removed with proot-distro disappears from XDesk too.
  • Before X has ever run, XDesk still lists your programs (without icons until the first one opens).
  • LXDE, KDE Plasma, Openbox and i3 are found as desktops too.

New: the command and the app stay in step

  • xdesk version shows the command's version.
  • When the command is older than the app, the Termux tab says so and offers Update command.
  • xdesk update stays on its line: a beta command moves to the newest beta, or to the release that follows it; a stable one only to stable releases. xdesk update beta and xdesk update stable switch lines.
  • The update downloads the release's own install script and checks it against the release's checksums.
  • The installer installs the newest stable release by default; XDESK_VERSION=beta gives the newest beta. The install line XDesk copies always names the app's own version.

New: when a program does not open, XDesk says why

Before, XDesk waited 15 seconds and pointed to a log file. Now it says at once:

  • the program is not installed (checked before it starts);
  • a library is missing (named);
  • it crashed (with the signal);
  • it cannot reach the display;
  • its graphics failed: XDesk then tries once more with software rendering, and tells you when that worked;
  • it ran and exited without opening a window (a command-line program, or one that is already open elsewhere).

New: xdesk doctor

One command checks the setup, one line per item, each with the fix:

  • the command and loader, and Termux's permission for other apps;
  • the packages needed, the window manager, sound, Chinese fonts, the cursor theme;
  • every environment: its programs and desktops, hardware GPU or software rendering, and in containers the PulseAudio library sound needs;
  • the X server, including one still running the code from before an app update.

GPU and sound in containers

  • A container with the Turnip driver now gets the same hardware rendering setup as Termux.
  • Without it, programs use software rendering, and xdesk doctor says so.

Fixed (from a full review of the command)

  • A mistyped session name was accepted: xdesk start reported success, and xdesk switch stopped the running desktop first. Both now refuse an unknown name before doing anything.
  • xdesk stop could kill an unrelated process when the desktop had exited on its own and Android had given its process number to another program. xdesk now checks that a process is really the one it started.
  • Stopping a desktop always waited about 13 seconds: the clean logout never reached the session. It now does.
  • xdesk stop no longer stops a PulseAudio you started yourself.
  • Language and cursor size were fixed on the day of xdesk setup; they now follow the phone and the display each time.
  • Phones set to zh-Hans/zh-Hant locales got English menus.
  • Two commands at the same time could start two input methods, or write a broken program list that was never repaired.
  • A launch request with a missing value could make the command loop forever.
  • Session names with spaces, tabs or quotes broke the lists the app reads; new names are now checked.
  • .desktop files with Windows line endings were ignored.
  • Reading the state is about ten times faster with several environments.

Upgrading

  • Install the APK over beta 4, then run the install line above once in Termux.
  • Receivers and the Mac app are the same as in beta 2.

XDesk 0.6.0 测试版 5

Linux 这一侧的测试版:只装 Termux 就能用,xdesk 命令和 App 自动对齐,程序打不开时会说明原因。可以直接覆盖安装在测试版 4 及之前的测试版上,也可以装在 0.5.1 上;0.5.1 仍是最新的正式版。测试版 2 到 4 的内容全部保留。

**装好 APK 后,在 Termux 里再运行一次安装命令。**新 App 需要新的 xdesk 命令;以后 App 会自己提示更新:
curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | XDESK_VERSION=v0.6.0-beta.5 bash

新功能:只装 Termux 就能用

  • 不需要桌面。安装脚本会装上窗口管理器(xfwm4),你装的程序(pkg install firefox,或者装在 proot 容器里的)可以一个一个单独打开到外屏上。
  • 每个 proot-distro 容器都是一个独立的环境,有没有桌面都行。
  • 之后再装的容器和桌面,XDesk 会自己发现,不用再运行 xdesk setup。用 proot-distro 删掉的容器,XDesk 里也会跟着消失。
  • X 还没启动过时,XDesk 也能列出你的程序(先没有图标,打开第一个程序后就有了)。
  • 桌面还认 LXDE、KDE Plasma、Openbox 和 i3。

新功能:命令和 App 自动对齐

  • xdesk version 显示命令的版本。
  • 命令比 App 旧时,Termux 那一栏会提示,并给出「更新命令」。
  • xdesk update 沿着当前这条线更新:测试版的命令升到最新的测试版,或者升到之后的正式版;正式版的命令只升到正式版。xdesk update beta、xdesk update stable 换线。
  • 更新时下载的是那个版本自己的安装脚本,并用那个版本的校验值核对。
  • 安装脚本默认装最新的正式版,XDESK_VERSION=beta 装最新的测试版。XDesk 帮你复制的安装命令总是带 App 自己的版本。

新功能:程序打不开时,XDesk 会说原因

以前要等 15 秒,然后让你去看日志文件。现在马上告诉你:

  • 程序没装好(启动前就会检查);
  • 缺少某个库(给出库名);
  • 程序崩溃了(给出信号);
  • 连不上显示;
  • 图形初始化失败:这时 XDesk 会用软件渲染再试一次,成功了也会告诉你;
  • 程序运行完就退出了,没有打开窗口(命令行程序,或者已经在别处打开的程序)。

新功能:xdesk doctor

一条命令检查整套设置,每项一行,并说怎么修:

  • 命令和加载器、Termux 是否允许别的应用运行命令;
  • 需要的包、窗口管理器、声音、中文字体、光标主题;
  • 每个环境:有几个程序和桌面,GPU 是硬件加速还是软件渲染,容器里有没有声音需要的 PulseAudio 库;
  • X 服务器,包括还在跑 App 更新前代码的情况。

容器里的 GPU 和声音

  • 装了 Turnip 驱动的容器,现在和 Termux 一样走硬件加速。
  • 没装的用软件渲染,xdesk doctor 会说明。

修复(来自对命令的一次全面审查)

  • 会话名打错了也被接受:xdesk start 报成功,xdesk switch 还会先停掉正在用的桌面。现在名字不对,什么都不做就直接拒绝。
  • 桌面自己退出后,如果 Android 把它的进程号分给了别的程序,xdesk stop 可能误杀那个程序。现在会先确认进程真是自己启动的那个。
  • 停桌面总要等 13 秒左右:正常注销一直没有送到会话。现在能送到了。
  • xdesk stop 不再停掉你自己开的 PulseAudio。
  • 语言和光标大小以前停在运行 xdesk setup 那天的设置,现在每次都跟着手机和屏幕走。
  • 语言设成 zh-Hans/zh-Hant 格式的手机,菜单会变成英文。
  • 两个命令同时运行时,可能启动两个输入法,或者写坏程序列表而且不会再修好。
  • 启动请求缺一个参数时,命令可能一直空转。
  • 会话名带空格、tab 或引号会弄坏 App 读的列表;现在新增时会检查名字。
  • Windows 换行格式的 .desktop 文件被忽略。
  • 环境多的时候,读取状态快了大约十倍。

升级

  • APK 覆盖安装在测试版 4 上,然后在 Termux 里运行一次上面的安装命令。
  • 接收端和 Mac App 和测试版 2 相同。

XDesk v0.6.0-beta.4

XDesk v0.6.0-beta.4 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:49

XDesk 0.6.0 beta 4

中文说明见下方

A fix for game passthrough from beta 3. It installs over beta 3, beta 2, beta 1 or 0.5.1, which stays the latest stable release. Everything in beta 2 and beta 3 still applies.

Fixed

  • Game passthrough no longer turns itself on. In beta 3, GeForce NOW, Steam Link and Moonlight entered it automatically. That fought the touch on the phone that ends it: when the app changed pages (GeForce NOW going from its store to a game) it counted as a new app, so passthrough came straight back, and it took two presses of Ctrl+Alt+G to really get in. Now only Ctrl+Alt+G turns it on, and it goes in and out with a single press.

Game passthrough, as it is now

  • Ctrl+Alt+G with an Android app on the external screen: the app gets the real keyboard and mouse (cloud gaming such as GeForce NOW, Steam Link, Moonlight). XDesk's cursor hides.
  • Ctrl+Alt+G again, or a touch on the phone, ends it.
  • The keyboard and mouse must be connected to the phone. The picture can still go to a wireless receiver.

Upgrading

  • Install the APK over beta 3. The xdesk command, the receivers and the Mac app are the same as in beta 2 and beta 3.

XDesk 0.6.0 测试版 4

修复测试版 3 的游戏直通。可以直接覆盖安装在测试版 3、测试版 2、测试版 1 或 0.5.1 上;0.5.1 仍是最新的正式版。测试版 2 和测试版 3 的内容全部保留。

修复

  • 游戏直通不再自己打开。 测试版 3 里 GeForce NOW、Steam Link、Moonlight 会自动进入直通,结果和「碰手机退出」打架:应用换页面时(GeForce NOW 从商店页进到游戏)被当成新应用,直通马上又开了,要按两次 Ctrl+Alt+G 才真正进去。现在只有 Ctrl+Alt+G 能打开,按一次进、按一次出。

现在的游戏直通

  • 外屏上是安卓应用时按 Ctrl+Alt+G:应用直接拿到真实的键鼠(GeForce NOW、Steam Link、Moonlight 这类云游戏),XDesk 的光标藏起来。
  • 再按一次 Ctrl+Alt+G,或者碰一下手机,退出。
  • 键鼠要连在手机上;画面照样可以无线投到接收端。

升级

  • APK 覆盖安装在测试版 3 上。xdesk 命令、接收端和 Mac App 和测试版 2、3 相同。

XDesk v0.6.0-beta.3

XDesk v0.6.0-beta.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:21

XDesk 0.6.0 beta 3

中文说明见下方

A small beta on top of beta 2: the phone becomes a game console. It installs over beta 2, beta 1 or 0.5.1, which stays the latest stable release. Everything in beta 2 still applies.

New: game passthrough

Cloud gaming apps such as GeForce NOW run fine on the external screen, and a gamepad has always worked. A keyboard and mouse did not: XDesk sends them on as injected events, and these apps want the real ones.

  • Press Ctrl+Alt+G with an Android app on the external screen: XDesk lets go of the keyboard and mouse, the app gets the real ones, and XDesk's cursor hides. Mouse look, WASD and every key work as on a PC.
  • Ctrl+Alt+G again, or a touch on the phone, ends it: the keyboard and mouse are XDesk's again.
  • GeForce NOW, Steam Link and Moonlight go into game passthrough by themselves when they open on the external screen. (Changed in beta 4: no longer automatic, only Ctrl+Alt+G turns it on.)
  • The keyboard and mouse must be connected to the phone (Bluetooth or USB). The picture can still go to a wireless receiver, such as a projector.
  • While it is on, the Dock, the notification centre and the other XDesk shortcuts wait until you leave it.

Changes

  • The split screen prototype is no longer in Settings: input did not reach the apps yet and it could not always be closed. The work continues in #10.

Upgrading

  • Install the APK over beta 2. Run the installer again in Termux for the new xdesk command if you have not since beta 2:
    curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | bash
  • Receivers and the Mac app are the same as in beta 2.

XDesk 0.6.0 测试版 3

在测试版 2 上的一个小测试版:手机成了一台游戏主机。可以直接覆盖安装在测试版 2、测试版 1 或 0.5.1 上;0.5.1 仍是最新的正式版。测试版 2 的内容全部保留。

新功能:游戏直通

GeForce NOW 这类云游戏在外屏上跑得很好,手柄也一直能用;键盘和鼠标却不行:XDesk 把它们当模拟事件转发,而这些应用要的是真实的键鼠事件。

  • 外屏上是安卓应用时按 Ctrl+Alt+G:XDesk 放开键鼠,应用直接拿到真实的键鼠,XDesk 的光标藏起来。鼠标转视角、WASD 和所有按键都和在电脑上一样。
  • 再按一次 Ctrl+Alt+G,或者碰一下手机,就退出直通,键鼠回到 XDesk。
  • GeForce NOW、Steam Link、Moonlight 在外屏上打开时自动进入游戏直通。(已在测试版 4 改掉:不再自动进入,只用 Ctrl+Alt+G 打开。)
  • 键鼠要连在手机上(蓝牙或 USB)。画面照样可以无线投到接收端,比如投影机。
  • 直通期间,Dock、通知中心和 XDesk 的其他快捷键要等退出直通后才能用。

改动

  • 设置里拿掉了分屏原型:输入还进不了应用,有时也关不掉。后续在 #10 里继续。

升级

  • APK 覆盖安装在测试版 2 上。测试版 2 之后还没重新运行过安装脚本的话,在 Termux 里运行一次,拿到新的 xdesk 命令:
    curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | bash
  • 接收端和 Mac App 和测试版 2 相同。

XDesk v0.6.0-beta.2

XDesk v0.6.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 17:52

XDesk 0.6.0 beta 2

中文说明见下方

The second beta of 0.6.0. It brings the phone's notifications to the external screen, the menus of Mac apps, and a single cursor style, and fixes what beta 1 testing found. It installs over 0.6.0 beta 1 or 0.5.1, which stays the latest stable release.

New features

Notifications on the external screen

  • The phone's notifications appear on the external screen as banners at the top right, and stay in a notification centre.
  • Open the centre in three ways: push the pointer out through the top-right corner, click the bell, or press Ctrl+Alt+N. The bell shows how many are unread.
  • The centre shows the time, date and the phone's battery on one line, your notifications grouped by app, Do not disturb and Clear all. Click a notification to open its app on the external screen; reply where the app allows it. The keyboard works it too: ↑↓, Enter, Delete, R (reply), Esc.
  • Low battery banners at 15% and 5% while not charging.
  • Settings › Notifications (also on the first settings page): what banners say (everything, app name only, none), per app (banner + centre, centre only, hidden), the bell, the low-battery banners.
  • It needs Android's notification access for XDesk. XDesk offers it once when an external screen is first used. If the system's switch is grey or says "Restricted setting" (apps not installed from a store, Android 13 and later), the Notifications page explains the way through and opens XDesk's app info page. Without the access everything works as before.
  • Nothing of a notification is stored or sent anywhere; it lives in memory only. Not shown on a car screen.

Menus of Mac apps

  • With a single Mac window or app on the external screen, a ≡ button sits at the top left, the twin of the bell. Click it, push the pointer out through the top-left corner, or press Ctrl+Alt+Space to open the app's menu bar.
  • Menus drop down as on the Mac: titles, shortcuts, check marks, greyed items, separators and submenus. The item under the pointer is highlighted; the keyboard works it with ←→ ↑↓ Enter Esc.
  • On the phone, a Mac item's card has a Menu row with the same menus as a list.
  • It needs Sill to be allowed under Accessibility on the Mac; the bar says so when it is not.

Closing and quitting

  • Quitting a Mac app really quits it (from its menu, ⌘Q, or Quit on the app's item under Running), so apps no longer pile up on the Mac.
  • A Mac window's card has Close (the window only); a Mac app's has Quit.
  • One rule when what is on the screen goes away (closed, quit, the X desktop restarted): the screen goes back to what was there before, or else to the Launchpad.

One cursor

  • The Launchpad's pointer is the same arrow as everywhere else, no longer a blue dot.
  • The X side gets a black arrow with a white edge, sized for the screen like XDesk's own (pkg install adwaita-icon-theme in Termux). It applies only to sessions XDesk starts; a desktop you start some other way keeps its cursor.
  • Receivers know whether the picture already has a cursor, so a receiver no longer shows two; a tablet's mouse over an Android app gets the phone's arrow.

Car (Android Auto)

  • Everything is sized for the distance of a car screen.
  • Sound follows Android Auto being connected.
  • No Launchpad on the car; the screen size setting says it does not apply there.

Experiments

  • Split screen prototype (Settings › Experiments): two Android apps side by side on the external screen, each on a display of its own, the mouse working the side it is over. A test to judge smoothness and input, not a finished feature.

xdesk command

  • xdesk add NAME 'COMMAND' --root DIR --launch 'PREFIX' for chroot environments: where their apps are listed from and how they are started.

Improvements and fixes

  • The Dock opens again over Android apps by pushing the pointer against the bottom edge (broken since the notification work after beta 1).
  • Fixed a crash when what is on the screen goes away, for example when the X desktop is restarted.
  • The Launchpad opened over an Android app turns pages with the mouse wheel again.
  • The pointer stays above the notification centre, the Mac menus and the Dock instead of going under them, over every content.
  • The corner buttons (≡ and the bell) have a dark plate, so they read over a light picture; both are as high as the Mac menu bar.

Known limits

  • The receiver paths (XDesk Receiver, the web page, the Mac app) were not retested on real devices for this beta.
  • The split screen is a prototype: input focus between the two sides and the frame rate shown are rough.
  • Mac sound is not synchronised with the picture.
  • Windows PCs, the file shelf and receiver protocol v3 come later.

Upgrading

  • Install the APK over beta 1 or 0.5.1. If the desktop was running during the update, XDesk asks once to restart the X server (programs on it close).
  • Run the installer again in Termux to get the new xdesk command:
    curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | bash
  • For the X cursor: pkg install adwaita-icon-theme in Termux.
  • On receivers, install the new xdesk-receiver.apk, and on a Mac the new XDesk-macos-arm64.dmg.
  • Mac support is a client for Sill by Noah Saffer, following Sall, a third-party Android client for Sill by n2ray. Neither XDesk nor Sall is an official Sill app.

XDesk 0.6.0 测试版 2

0.6.0 的第二个测试版:把手机通知带到外屏,加上 Mac 应用的菜单和统一的光标,并修好测试版 1 测出来的问题。可以直接覆盖安装在 0.6.0 测试版 1 或 0.5.1 上;0.5.1 仍是最新的正式版。

新功能

外屏上的通知

  • 手机的通知会在外屏右上角弹出横幅,并留在通知中心里。
  • 三种方式打开通知中心:把鼠标推出右上角、点铃铛、按 Ctrl+Alt+N。铃铛上显示未读数。
  • 通知中心顶上一行是时间、日期和手机电量,下面是按应用分组的通知,还有勿扰和全部清除。点一条通知会在外屏打开对应的应用;应用允许时可以直接回复。也能用键盘:↑↓、Enter、Delete、R(回复)、Esc。
  • 未充电时电量到 15% 和 5% 会弹低电量横幅。
  • 设置 ›「通知」(设置首页也有):横幅显示什么(全部、只显示应用名、不弹)、按应用(横幅 + 通知中心、只进通知中心、不显示)、铃铛、低电量横幅。
  • 需要给 XDesk 开 Android 的「通知使用权」。第一次接外屏时 XDesk 会问一次。系统开关是灰的、或提示「受限设置」时(Android 13 起,不是从应用商店装的应用都会这样),「通知」页里写了怎么放行,并能直接打开 XDesk 的应用详情页。不开这个权限,其他功能照旧。
  • 通知内容不落盘、不外传,只在内存里。车机屏上不显示。

Mac 应用的菜单

  • 外屏上是单个 Mac 窗口或应用时,左上角有一个 ≡ 按钮,和铃铛是一对。点它、把鼠标推出左上角、或按 Ctrl+Alt+Space,打开这个应用的菜单栏。
  • 下拉菜单和 Mac 上一样:标题、快捷键、勾选、灰色的不可用项、分隔线、子菜单。鼠标经过的项会高亮;也能用键盘 ←→ ↑↓ Enter Esc 操作。
  • 手机上 Mac 项目的卡片里有「菜单」一行,以列表显示同样的菜单。
  • 需要在 Mac 的「辅助功能」里允许 Sill;没允许时菜单栏会提示。

关闭和退出

  • 退出 Mac 应用会真的退出(菜单、⌘Q、或「正在运行」里应用项的「退出」),Mac 上不会再越开越多。
  • Mac 窗口的卡片是「关闭」(只关这个窗口);Mac 应用的卡片是「退出」。
  • 外屏上的内容没了(关掉、退出、重启 X 桌面)时,统一回到之前的内容,没有就回启动台。

统一的光标

  • 启动台的鼠标和其他地方一样是箭头,不再是蓝色小圆点。
  • X 这边用带白边的黑箭头,大小和 XDesk 自己的界面一致(Termux 里 pkg install adwaita-icon-theme)。只对 XDesk 启动的会话生效;用别的方式起的桌面保留自己的光标。
  • 接收端知道画面里是否已经带光标,不会再出现两个光标;平板的鼠标在安卓应用上显示手机的箭头。

车机(Android Auto)

  • 所有界面按车机屏的观看距离放大。
  • 声音跟随 Android Auto 的连接切换。
  • 车机上没有启动台;屏幕尺寸设置会注明在车机上不适用。

实验功能

  • 分屏原型(设置 › 实验):外屏左右并排两个安卓应用,各自在独立的显示器上,鼠标在哪边就操作哪边。用来判断流畅度和输入方式,还不是正式功能。

xdesk 命令

  • xdesk add 名字 '命令' --root 目录 --launch '前缀',给 chroot 环境指定从哪里列出应用、怎么启动它们。

改进和修复

  • 安卓应用上又能推底边呼出 Dock 了(测试版 1 之后做通知功能时弄坏的)。
  • 修复崩溃:外屏上的内容没了(比如重启 X 桌面)时 XDesk 会崩溃。
  • 在安卓应用上打开的启动台又能用鼠标滚轮翻页了。
  • 在所有内容上,鼠标都会留在通知中心、Mac 菜单和 Dock 的上面,不再被盖住。
  • 角落的两个按钮(≡ 和铃铛)加了深色底板,在浅色画面上也看得清,高度和 Mac 菜单栏一致。

已知局限

  • 这次没有在真机上重测接收端(XDesk 接收器、网页端、Mac App)。
  • 分屏只是原型:两边之间的输入焦点、显示的帧率都还粗糙。
  • Mac 的声音和画面没有同步。
  • Windows 电脑、文件中转架、接收端协议 v3 以后再做。

升级

  • APK 直接覆盖安装在测试版 1 或 0.5.1 上。更新时桌面在运行的话,XDesk 会问一次是否重启 X(上面的程序会关闭)。
  • 在 Termux 里重新运行安装脚本,拿到新的 xdesk 命令:
    curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | bash
  • X 光标:Termux 里 pkg install adwaita-icon-theme。
  • 接收端装新的 xdesk-receiver.apk,Mac 上装新的 XDesk-macos-arm64.dmg。
  • Mac 支持是 Noah Saffer 的 Sill 的客户端,参照了 n2ray 写的第三方 Sill 安卓客户端 Sall。XDesk 和 Sall 都不是 Sill 官方应用。

XDesk v0.6.0-beta.1

XDesk v0.6.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 12:50

XDesk 0.6.0 beta 1

中文说明见下方

This is a beta of 0.6.0, a large rework of how XDesk shows things on the external screen and how you move between them. It installs over 0.5.1, which stays the latest stable release. The new parts have had less testing than the rest; see Known limits.

New features

One switchboard for everything

  • The phone's list, the external screen's home (the Launchpad) and the Dock are one model: the same tabs (Running, Favourites, Phone, then one per device), the same items, the same order. Changing the tab or the search on one screen changes it on the other.
  • Search covers every device at once, with pinyin initials; the current device's results come first.
  • With a mouse attached, the phone stays on the list after something opens (the phone is the switcher, the touchpad is one tap away); without one it goes to the touchpad as before.
  • Item card: long-press an item on the phone, or right-click it on the external screen, for one card with everything about it: Open / Switch to, Close or Quit, Hide, favourite and its place, and the item's own settings. For the item already on the screen the first button is Open the Launchpad.
  • Device badges: icons of a Mac's or a Linux environment's items carry a small badge at the bottom-left (a display for a Mac, >_ for Termux, the distro's initial for proot or chroot), in a colour fixed per device. The phone's own apps have none, so the same app on two devices can be told apart.

The Dock, the same everywhere

  • Push the pointer against the bottom edge of the external screen to open the Dock, over any content: Android apps, Linux windows and desktops, a Mac.
  • It shows what is on the screen, the previous item, your favourites and All; right-click an icon for its card.
  • When there are more favourites than fit, the icons shrink first; if they still don't fit, a +N tile says how many are left out and opens the Launchpad's favourites.

Devices, added when you want them

  • A first start shows only the phone's own apps. Linux and Macs are added in Settings › Connect device › Add device.
  • Linux: Termux itself and every proot or chroot environment the xdesk command knows are devices of their own, with their apps always listed. Opening a Linux program starts a light X (window manager only, no desktop) and shows the program full screen; Whole desktop is first in every Linux tab and the only thing that starts the desktop. Stop ends the X server.
  • Adding Termux asks for its permission and reads what is set up. With no xdesk in Termux yet, Install xdesk in Termux copies the install line and opens Termux.
  • If Termux is uninstalled or installed again, XDesk tells you and forgets what it knew of the old one.

Keyboard, mouse and input methods

  • A physical keyboard and mouse belong to the external screen by default, for every content. Ctrl+Alt+M gives them to the phone and back.
  • Whoever shows the picture composes the text: a Mac uses its own input method; Linux uses fcitx5 in Termux (if installed), with its candidate window on the external screen at the text. Shift+Space switches fcitx5's input method (Android keeps Ctrl+Space for itself).
  • The X side's keyboard layout is a setting: the Keyboard layout (X side) row on the Linux device page, or xdesk ime layout NAME (for example de, fr, de-nodeadkeys).
  • Per device: Keyboard types with the phone's input method, for when you prefer the phone's.

Mac (compatible with Sill)

XDesk's Mac support is a client for Sill by Noah Saffer, the open-source app that streams a Mac's windows and desktop to other devices. Install Sill 0.6.1 or later on the Mac (Apple silicon); XDesk pairs with it and speaks its protocol. The client follows Sall, a third-party Android client for Sill that I (n2ray) also wrote, and reuses its code under the Apache License 2.0. Neither XDesk nor Sall is an official Sill app; the Mac's stream settings belong to Sill and change for every device connected to it.

  • Mac windows, apps and the whole desktop as contents on the external screen. A locked Mac shows its lock screen and can be unlocked by typing.
  • Pairing by address and code, by scanning the QR code in Sill's pairing window, by a sill://pair link, or with Ask the Mac for a code.
  • Picture modes Sharp / Balanced / Smooth in one tap (Mac device page, the Mac item's card, the picture page); Ctrl+Alt+Q cycles them while a Mac is on the screen.
  • Lower quality automatically on a weak link (on by default): when the link falls behind for 5 seconds XDesk takes the Mac's suggestion, and after 2 calm minutes steps back towards the mode you chose.
  • Picture and sound page: quality, resolution, frame rate, encoding speed, virtual display, sound, and the round trip time with advice when it stays high.
  • Sound from the Mac, on by default (it needs Send Audio on in Sill). Mute this device; pulling the headphones the sound plays on mutes it instead of moving it to the loudspeaker.

Receivers (XDesk Receiver, the web page, the Mac app)

  • Overview (the Launchpad) and Switcher (the next item) on XDesk Receiver's handle and in its gestures; Back, Home and Overview on the web page's toolbar; Overview on the Mac app's bar.
  • A receiver's pointer opens the Dock over Linux and Mac content too, and works it.
  • The Mac app keeps Command and Ctrl apart when you control a Mac.
  • The phone's touch settings (natural scrolling, pointer and scroll speed) apply on the receivers.

Installer and Linux

  • On Adreno GPUs the installer adds Turnip, so Linux programs get the real GPU; Mesa falls back to software rendering where Turnip can't run.
  • The installer explains allow-external-apps and asks before turning it on.
  • New xdesk commands: envs, apps, launch, ime (status, setup, start, stop, on, off, layout), and NAME+apps sessions.

Improvements and fixes

  • The Launchpad and the Dock keep the same size whatever the Android apps' interface size is; they no longer shrink after an app or a Linux program changed it.
  • Mac windows and the Mac cursor are no longer resized by the Android apps' interface size. The setting is now called Android apps' interface size; the screen's Size sizes everything else.
  • The Dock no longer jitters when the pointer crosses the gaps between icons.
  • The Launchpad turns a page per mouse-wheel notch (it needed three).
  • Mac sound: a buffer that adapts to the network, so Wi-Fi or VPN jitter no longer cuts the sound.
  • Ctrl+Alt+M with the Dock open closes it.
  • One icon style for an item on every screen.
  • "Continue on the phone" appears on the external screen only when something really opens on the phone.
  • The X side's input method keeps working when you go from a single Linux program to the whole desktop.
  • fcitx5's candidate window shows (it was hidden by Termux's on-screen-keyboard mode).
  • Chromium and other programs that draw their own frame fill the screen without a shadow margin.
  • The mouse cursor over a Mac window no longer flickers; switching between Mac windows no longer says "another device".
  • Fixed: a crash when checking the X server's build, and a crash when disconnecting a Mac.
  • A key or button is released where it was pressed, also when the content changed in between.
  • An X server from an older XDesk build is detected after an update, with an offer to restart it.

Known limits

  • The receiver paths (XDesk Receiver, the web page, the Mac app) were not retested on real devices for this beta.
  • proot and chroot environments have had little testing.
  • Mac sound is not synchronised with the picture.
  • One content on the external screen at a time. Several windows side by side, Windows PCs and receiver protocol v3 come later.

Upgrading

  • Install the APK over 0.5.1. If the desktop was running during the update, XDesk asks once to restart the X server (programs on it close).
  • Run the installer again in Termux to get the new xdesk command:
    curl -fsSL https://raw.githubusercontent.com/n2ray/xdesk/xdesk/xdesk/install.sh | bash
  • If you already used Termux with XDesk, it stays a device; nothing to add.
  • On receivers, install the new xdesk-receiver.apk, and on a Mac the new XDesk-macos-arm64.dmg.

XDesk 0.6.0 测试版 1

这是 0.6.0 的测试版。这一版大幅改造了 XDesk 在外屏上显示内容、在内容之间切换的方式。可以直接覆盖安装在 0.5.1 上;0.5.1 仍然是最新的正式版。新功能测得比原有部分少,见下面的「已知局限」。

新功能

一个交换台管所有内容

  • 手机上的列表、外屏的主页(启动台)和 Dock 用的是同一份内容:同样的页签(正在运行、收藏、手机,然后每个设备一个)、同样的项目、同样的顺序。在一块屏上切换页签或搜索,另一块屏跟着变。
  • 搜索一次覆盖所有设备,支持拼音首字母,当前设备的结果排在最前面。
  • 接着鼠标时,打开内容后手机停留在列表上(手机当切换器用,触摸板点一下就到);没接鼠标时照旧进入触摸板。
  • 卡片:在手机上长按某一项,或在外屏上右键点它,弹出一张包含这一项所有操作的卡片:打开 / 切换到、关闭或退出、隐藏、收藏和收藏里的位置,以及这一项自己的设置。正在外屏上的那一项,第一个按钮是打开启动台。
  • 设备小标记:Mac 和 Linux 环境里的项目,图标左下角带一个小徽章(Mac 是显示器图形,Termux 是 >_,proot 或 chroot 是发行版首字母),每台设备一个固定颜色。手机自己的应用没有徽章,所以两台设备上的同一个应用一眼就能分开。

Dock:所有内容上用法一样

  • 把鼠标推到外屏底边再往下推一点,Dock 就出来了。安卓应用、Linux 窗口和桌面、Mac 上都一样。
  • 里面是正在显示的、上一个、你的收藏和全部;右键点图标打开它的卡片。
  • 收藏太多放不下时,先把图标缩小;还放不下就出现一格 +N,说明还有几个没放下,点它打开启动台的收藏页。

设备按需添加

  • 第一次打开只有手机自己的应用。Linux 和 Mac 在 设置 › 连接设备 › 添加设备 里添加。
  • Linux:Termux 本身,以及 xdesk 命令知道的每个 proot 或 chroot 环境,各自是一台设备,应用一直列着。打开一个 Linux 程序会起一个轻量 X(只有窗口管理器,没有桌面),程序全屏显示;每个 Linux 页签第一项是整个桌面,只有它会启动完整桌面。停止会结束 X 服务器。
  • 添加 Termux 时会请求它的权限并读取已有的设置。Termux 里还没有 xdesk 时,在 Termux 里安装 xdesk 会复制安装命令并打开 Termux。
  • Termux 被卸载或重新安装后,XDesk 会提示你,并清掉记下的旧 Termux 的一切。

键盘、鼠标和输入法

  • 实体键盘和鼠标默认交给外屏,所有内容都一样。Ctrl+Alt+M 把它们交给手机,再按一次交回外屏。
  • 谁显示画面,就由谁的输入法打字:Mac 用它自己的输入法;Linux 用 Termux 里的 fcitx5(装了的话),候选框出现在外屏的文字旁边。Shift+空格 切换 fcitx5 的输入法(Ctrl+空格被安卓自己占用)。
  • X 这边的键盘布局成了一个设置:Linux 设备页里的键盘布局(X 这边),或命令 xdesk ime layout 名称(例如 de、fr、de-nodeadkeys)。
  • 每台设备都有实体键盘用手机输入法打字,喜欢用手机输入法时打开。

Mac(兼容 Sill)

XDesk 的 Mac 支持是 Sill 的客户端。Sill 是 ...

Read more

XDesk v0.5.1

Choose a tag to compare

@github-actions github-actions released this 11 Nov 22:22

What's new

  • Control the phone from a tablet receiver. XDesk Receiver on a tablet or old phone now works the phone, not only shows it:
    • In Mouse & keyboard mode, and on the Linux desktop, its screen is a touchpad for the phone's cursor, with the phone's gestures. In Touch mode you tap where you want. A switch on the receiver's handle changes it for the current app.
    • Tapping a text box opens the phone's own keyboard on the picture, and the app moves the text box above it. Keys are pressed where your finger is, so a held Delete repeats.
    • A mouse and keyboard connected to the receiver work too. Clipboard text is shared, and files sent from the phone land in the receiver's Downloads.
    • The handle on the receiver's right edge is now blue and easier to see.
  • Dual apps. Apps in a clone profile (HyperOS dual apps) and work profile apps show up in the app list, marked "(dual)". They start and close on their own, without touching the original.
  • Connecting. The phone connects to a tablet only when you choose it, and a Mac plugged in over USB no longer takes over a stream that is running.

Update XDesk Receiver together with the phone app.

更新内容

  • 平板接收器可以直接操作手机。 装在平板或旧手机上的 XDesk 接收器,不只显示画面,也能操作手机:
    • 键鼠模式下(Linux 桌面也是),它的屏幕就是触摸板,手势和手机触摸板一样;触控模式下点哪是哪。接收器右边把手里可以临时切换。
    • 点输入框时,手机自己的键盘会出现在画面里,应用会把输入框推到键盘上方。按键按在手指下面,按住退格能连续删。
    • 接收器上接的鼠标、键盘也能用;剪贴板文字两边共享,手机发来的文件存到接收器的「下载」。
    • 接收器右边的把手改成蓝色,更好找。
  • 双开应用。 双开(克隆分身)和工作资料里的应用会出现在应用列表里,标着「(双开)」,和原版分开启动、关闭。
  • 连接。 只有你选了平板,手机才会去连它;正在投屏时插上 Mac,不会再把投屏抢走。

手机端和接收器请一起更新。

Full Changelog: v0.5.0...v0.5.1

XDesk v0.5.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:42

Full Changelog: v0.3.9...v0.5.0

XDesk v0.3.9

Choose a tag to compare

@github-actions github-actions released this 10 Nov 14:13

Full Changelog: v0.3.8...v0.3.9

XDesk v0.3.8

Choose a tag to compare

@github-actions github-actions released this 10 Nov 13:15

Full Changelog: v0.3.7...v0.3.8

XDesk v0.3.7

Choose a tag to compare

@github-actions github-actions released this 10 Nov 12:12

Full Changelog: v0.3.6...v0.3.7