如何让Strata成为默认文件管理器:桌面条目与Open File Location集成完整指南
如何让Strata成为默认文件管理器:桌面条目与Open File Location集成完整指南
Strata 是 Linux 上一款快速、键盘优先的文件管理器,支持列视图、模糊搜索与丰富预览。这篇指南将带你完成两个关键集成:安装桌面条目(desktop entry) 让 Strata 成为默认文件夹处理器,接入 Open File Location(D-Bus FileManager1 接口) 让浏览器和 GTK 应用"在文件管理器中显示位置"时也能打开 Strata。全程只改用户目录配置,无需 root 权限。
为什么需要两套集成?
🤔 很多用户装完 Strata 后发现"默认文件管理器"没生效,其实是因为 Linux 桌面有两条独立的调用路径:
| 调用路径 | 触发场景 | 由什么决定 |
|---|---|---|
| XDG 类型关联 | 双击文件夹、应用通过 xdg-open 打开目录 |
inode/directory 的默认桌面条目 |
D-Bus org.freedesktop.FileManager1 |
浏览器"打开文件所在位置"、GTK/GNOME 应用定位文件 | 用户 D-Bus 服务上注册的 FileManager1 服务 |
两条路径都要配置,Strata 才算真正"接管"了桌面。相关实现分别位于 data/io.github.lgse.Strata.desktop(桌面条目模板)和 src/adapters/file_manager1.rs(D-Bus 接口定义)。
安装前的快速准备清单
在开始之前,确认满足以下条件:
- ✅ Strata 已安装到稳定路径,通常为
~/.local/bin/strata,并能在终端直接运行; - ✅ 系统已安装
xdg-user-dirs/desktop-file-utils提供的xdg-mime、update-desktop-database工具; - ✅ 手里有当前版本的发布压缩包(内含
io.github.lgse.Strata.desktop和io.github.lgse.Strata.FileManager1.service两个文件)。
💡 如果你是从源码构建的,可以直接用
mise run install-local一键安装二进制、图标和桌面条目。
一键安装步骤:桌面条目(Desktop Entry)
桌面条目让 Strata 出现在应用菜单、Dock 和任务切换器中,并注册为目录的默认打开程序。
1. 安装应用图标(使用发布包内的 SVG 图标):
cd ~/Downloads/<解压后的发布目录>
install -Dm644 io.github.lgse.Strata.svg \
~/.local/share/icons/hicolor/scalable/apps/io.github.lgse.Strata.svg
2. 安装桌面条目,并把 Exec= 指向你实际的二进制路径:
install -d ~/.local/share/applications
sed "s|^Exec=strata |Exec=$HOME/.local/bin/strata |" io.github.lgse.Strata.desktop \
> ~/.local/share/applications/io.github.lgse.Strata.desktop
update-desktop-database ~/.local/share/applications
3. 刷新图标缓存,并把 Strata 设为 inode/directory 的默认处理器:
gtk-update-icon-cache -qtf ~/.local/share/icons/hicolor 2>/dev/null || true
xdg-mime default io.github.lgse.Strata.desktop inode/directory
xdg-mime query default inode/directory # 应输出 io.github.lgse.Strata.desktop
最后一条命令打印出 io.github.lgse.Strata.desktop 即表示成功。桌面条目的文件名与 Strata 窗口上报的应用 ID 一致,因此桌面 shell 能把正在运行的窗口匹配到该条目并显示正确的 Icon。
小贴士: 如果 Dock 里图标没出现或显示旧图标,注销再登录一次即可,很多 shell 会缓存启动器图标。
Open File Location 集成:最快配置方法
浏览器(如 Firefox 下载完成后点击路径)和 GNOME/GTK 应用定位文件时,不走 inode/directory 关联,而是直接调用 D-Bus 上的 org.freedesktop.FileManager1 接口。没有这一步,即使 Strata 已是默认文件夹处理器,"在文件管理器中显示位置"仍会打开别的程序。
Strata 的 D-Bus 激活服务模板见 data/io.github.lgse.Strata.FileManager1.service:
[D-BUS Service]
Name=org.freedesktop.FileManager1
Exec=/usr/bin/strata --gapplication-service
1. 把 Exec= 改成你的实际路径,安装到用户 D-Bus 服务目录:
cd ~/Downloads/<解压后的发布目录>
install -d ~/.local/share/dbus-1/services
sed "s|^Exec=/usr/bin/strata |Exec=$HOME/.local/bin/strata |" \
io.github.lgse.Strata.FileManager1.service \
> ~/.local/share/dbus-1/services/io.github.lgse.Strata.FileManager1.service
2. 避免服务冲突:检查 ~/.local/share/dbus-1/services/ 下是否已有其他文件的 Name=org.freedesktop.FileManager1 服务。同一目录里出现两个同名服务时,系统会随机挑选其一;如果另一个文件管理器当前正在运行,先退出它再测试。
3. 验证接管是否生效。Strata 会响应 ShowFolders、ShowItems、ShowItemProperties 三个方法,用 busctl 手动调用一次:
busctl --user call org.freedesktop.FileManager1 /org/freedesktop/FileManager1 \
org.freedesktop.FileManager1 ShowItems ass 1 "file://$HOME/Downloads" ""
如果 Strata 弹出窗口、打开 Downloads 目录并选中其中条目,说明集成成功。
偷懒方案:用官方安装脚本一次搞定
如果你用的是发布版,install.sh 提供了三个可选参数,覆盖上面全部步骤:
| 参数 | 作用 |
|---|---|
--with-desktop-entry |
安装桌面条目,把 Strata 加入应用菜单 |
--with-file-manager |
单独启用 "Open file location"(D-Bus)集成 |
--with-folder-association |
设为默认文件夹处理器,自动包含桌面条目和 --with-file-manager |
最省事的做法是在安装时追加 --with-folder-association 一个参数,三件事一起完成。注意:文件选择器(Open/Save 对话框)替换是独立选项 --with-file-chooser,不会随默认文件管理器自动开启,详见 docs/portal-file-chooser.md。
Omarchy 用户:快捷键也要换
🎯 在 Omarchy 桌面上,除了上述 XDG 关联,还要把预置的 Nautilus 快捷键改指向 Strata。在 ~/.config/hypr/bindings.lua 末尾追加(先备份原文件):
hl.unbind("SUPER + SHIFT + F")
hl.unbind("SUPER + ALT + SHIFT + F")
o.bind("SUPER + SHIFT + F", "File manager", { launch = "strata" })
o.bind("SUPER + ALT + SHIFT + F", "File manager (cwd)",
"uwsm-app -- strata \"$(omarchy-cmd-terminal-cwd)\"")
然后执行 hyprctl reload 并用 hyprctl configerrors 确认无错误即可。这些用户级覆盖在 Omarchy 升级后依然保留。
验证与常见问题排查
配置完成后,按这个清单逐项确认:
- 应用菜单里能看到带图标的 Strata 条目;
xdg-mime query default inode/directory输出io.github.lgse.Strata.desktop;- 双击任意文件夹直接打开 Strata;
- 浏览器中"在文件管理器中显示位置"打开的是 Strata 且自动选中目标文件。
常见问题:
- Dock 图标不显示 / 显示旧图标:注销重新登录,刷新 shell 缓存。
ShowItems没反应:多半是另一个文件管理器的用户服务仍占用org.freedesktop.FileManager1总线名,移除对应服务文件或退出该程序后再试。- 想恢复原状:删除
~/.local/share/applications/io.github.lgse.Strata.desktop和~/.local/share/dbus-1/services/io.github.lgse.Strata.FileManager1.service,重新运行update-desktop-database,并把inode/directory关联指回原文件管理器即可;偏好设置保存在 XDG 配置目录中,卸载不影响个人设置。
设置完成后,Strata 就能从"一个应用"升级为桌面真正的默认文件管理器:文件夹双击、下载定位、应用集成全都指向它。🚀


