// Applications and session startup. import Quickshell import QtQuick import qs.services SettingsPage { id: root objectName: "applications" title: "Applications" lede: "Choose what opens your files and links, and what starts with your session." property string expandedRole: "" readonly property var applications: DesktopEntries.applications.values readonly property var roles: [ { key: "browser", label: "Browser", detail: "Web links and HTML pages", categorySets: [["webbrowser"]], terms: ["web browser", "browser"] }, { key: "mail", label: "Mail", detail: "Email links", categorySets: [["email"]], terms: ["mail client", "email client"] }, { key: "files", label: "Files", detail: "Folders and file locations", categorySets: [["filemanager"]], terms: ["file manager"] }, { key: "terminal", label: "Terminal", detail: "Terminal links and command-line handoffs", categorySets: [["terminalemulator"]], terms: ["terminal emulator", "terminal"] }, { key: "music", label: "Music", detail: "MP3 audio", categorySets: [["music"], ["audio", "player"]], terms: ["music player", "audio player"] }, { key: "images", label: "Images", detail: "PNG images", categorySets: [], terms: ["image viewer", "image editor", "photo viewer", "photo editor", "picture viewer"] }, { key: "video", label: "Video", detail: "MP4 video", categorySets: [["video"]], terms: ["video player", "movie player"] } ] function desktopId(entry: var): string { const entryId = String(entry?.id ?? ""); return entryId.endsWith(".desktop") ? entryId : entryId + ".desktop"; } function displayName(entry: var): string { return String(entry?.name || entry?.genericName || root.desktopId(entry)); } function currentHandler(role: string): string { return String(DefaultApps.handlers[role] ?? ""); } function currentEntry(role: string): var { const handler = root.currentHandler(role); return root.applications.find(entry => root.desktopId(entry) === handler) ?? null; } function matchesRole(entry: var, role: var): bool { const rawCategories = Array.isArray(entry.categories) ? entry.categories : [String(entry.categories ?? "")]; const categories = []; for (const rawCategory of rawCategories) { for (const value of String(rawCategory).split(";")) { const category = value.trim().toLowerCase(); if (category !== "") categories.push(category); } } const metadata = [entry.name, entry.genericName] .map(value => String(value ?? "").toLowerCase()) .join(" "); return role.categorySets.some(set => set.every(category => categories.includes(category))) || role.terms.some(term => metadata.includes(term)); } function choicesForRole(role: var): var { const choices = root.applications.filter(entry => root.matchesRole(entry, role)); const currentEntry = root.currentEntry(role.key); if (currentEntry && !choices.some(entry => root.desktopId(entry) === root.desktopId(currentEntry))) choices.push(currentEntry); return choices.sort((left, right) => root.displayName(left).localeCompare(root.displayName(right))); } TextRow { visible: DefaultApps.lastError !== "" label: "Application settings need attention" detail: DefaultApps.lastError value: "" divider: false } SettingsCard { title: "Default applications" subtitle: "Open a row to choose from applications that advertise the matching role." Repeater { model: root.roles delegate: Column { id: roleBlock required property var modelData required property int index readonly property var choices: root.choicesForRole(roleBlock.modelData) readonly property var selectedEntry: root.currentEntry(roleBlock.modelData.key) width: parent.width SettingRow { label: roleBlock.modelData.label detail: roleBlock.modelData.detail value: DefaultApps.busy ? "Loading…" : ( roleBlock.selectedEntry ? root.displayName(roleBlock.selectedEntry) : (root.currentHandler(roleBlock.modelData.key) || "Not set") ) activatable: roleBlock.choices.length > 0 && !DefaultApps.busy divider: root.expandedRole !== roleBlock.modelData.key && roleBlock.index < root.roles.length - 1 onActivated: { root.expandedRole = root.expandedRole === roleBlock.modelData.key ? "" : roleBlock.modelData.key; } } Column { width: parent.width visible: root.expandedRole === roleBlock.modelData.key Repeater { model: roleBlock.choices delegate: SettingRow { id: candidateRow required property var modelData required property int index readonly property string candidateId: root.desktopId(candidateRow.modelData) readonly property bool selected: candidateRow.candidateId === root.currentHandler(roleBlock.modelData.key) label: root.displayName(candidateRow.modelData) detail: String(candidateRow.modelData.genericName || candidateRow.modelData.comment || candidateRow.candidateId) value: candidateRow.selected ? "Current" : "" activatable: !candidateRow.selected && !DefaultApps.busy divider: candidateRow.index < roleBlock.choices.length - 1 || roleBlock.index < root.roles.length - 1 onActivated: { DefaultApps.setDefault(roleBlock.modelData.key, candidateRow.candidateId); root.expandedRole = ""; } } } } } } } // GNOME's Search panel, answered honestly. // // It configures which applications provide results in gnome-shell's // overview and which folders are indexed. gnome-shell does not run here, // so those settings would do nothing. Under Panama searching is the // launcher's job, and Vicinae carries its own preferences -- reimplementing // them here would give two places to change one thing. SettingsCard { title: "Search" subtitle: "Applications, files, the calculator, clipboard history, emoji, and open windows are all searched from the launcher." TextRow { label: "Launcher" detail: SystemSettings.vicinaeActive ? "Running as a user service" : "Not running — Super+Shift+R opens the fallback launcher" value: "Vicinae" } TextRow { label: "Open search" detail: "Three keys open it, because Super+A and Super+R were GNOME's app grid and run dialog" value: "Super+Space" } ActionRow { label: "Change these shortcuts" detail: "Every launcher chord is rebindable, including clipboard history and emoji" action: "Open keyboard" divider: false onTriggered: ShellState.openSettings("shortcuts") } } SettingsCard { title: "User autostart" subtitle: "These desktop entries live in your user configuration. Select a row to toggle it." TextRow { visible: !DefaultApps.busy && DefaultApps.autostartEntries.length === 0 label: "No user autostart entries" detail: "Applications can add entries to ~/.config/autostart." value: "" divider: false } Repeater { model: DefaultApps.autostartEntries delegate: SettingRow { id: autostartRow required property var modelData required property int index label: autostartRow.modelData.name detail: autostartRow.modelData.id value: autostartRow.modelData.enabled ? "Enabled" : "Disabled" activatable: !DefaultApps.busy divider: autostartRow.index < DefaultApps.autostartEntries.length - 1 onActivated: DefaultApps.setAutostart(autostartRow.modelData.id, !autostartRow.modelData.enabled) } } } SettingsCard { title: "Compositor autostart" subtitle: "Panama starts these from Hyprland configuration. They are read-only here." TextRow { visible: !DefaultApps.busy && DefaultApps.luaAutostartEntries.length === 0 label: "No compositor entries found" detail: "No hl.exec_cmd entries were found in config/dot/hypr/autostart.lua." value: "" divider: false } Repeater { model: DefaultApps.luaAutostartEntries delegate: TextRow { id: luaRow required property var modelData required property int index label: luaRow.modelData.name detail: luaRow.modelData.command value: "Hyprland" divider: luaRow.index < DefaultApps.luaAutostartEntries.length - 1 } } } SettingsCard { title: "Refresh" ActionRow { label: "Reload application settings" detail: "Re-read desktop entries, defaults, and user autostart files" action: DefaultApps.busy ? "Refreshing…" : "Refresh" enabled: !DefaultApps.busy divider: false onTriggered: DefaultApps.refresh() } } }