Please note that this may not be respected by all applications but the command xdg-open will.

Junction has a very simple API that doesn't require any programming. To open any resource with Junction, even if it's not configured as the default application, simply use the following URI format x-junction://$RESOURCE. For examples

• x-junction://https://github.com
• x-junction://~
• x-junction://file:///etc/os-release
• x-junction:///etc/os-release

You can use this in web pages, the terminal, native applications and anything that is able to open URIs.

If Junction is installed - you can test this in the terminal with xdg-open "x-junction://file:///etc/os-release" and in the browser with <a href="x-junction://file:///etc/os-release">Test Junction URI</a>.

Use the menu or <Ctrl>? to learn about Keyboard usage. You can navigate the UI with the arrow keys too.

Use Middle-click, Ctrl+Click, Ctrl+Enter or Ctrl+Space to keep Junction open - allowing you to open the resource in multiple applications.

On GNOME you can make all new windows open in the center using

gsettings set org.gnome.mutter center-new-windows true

See https://gitlab.gnome.org/GNOME/mutter/-/issues/246

Create a permant alias, for example alias open="flatpak run re.sonny.Junction".

Then you can use open my-file.

See How To Create Permanent Aliases In Linux?

You can add your own script to Junction by creating a .desktop file for it in ~/.local/share/applications.

See https://wiki.archlinux.org/title/desktop_entries (distro agnostic).

Create a bookmark with the following URL

javascript:window.location='x-junction://'+window.location

See Profile Manager - Create, remove or switch Firefox profiles

If you want to be able to choose the Firefox profile to open the resource with, you can make desktop files for your Firefox profiles in ~/.local/share/applications.

Here is an example ~/.local/share/applications/firefox-work.desktop

[Desktop Entry]
Version=1.0
Name=Firefox work
Exec=firefox -P work --class=firefox-work %u
Icon=firefox
Terminal=false
Type=Application
StartupWMClass=firefox-work
MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
StartupNotify=true

Save, run update-desktop-database ~/.local/share/applications, enjoy.

Reference

Within Junction, you can toggle Show names in the menu or hover the application with the mouse to display a tooltip.

Otherwise, you can edit the desktop files to use distinctive icons, here are a some tools

• MenuLibre GUI
• AppEditor GUI
• ArchWiki advanced

If the application was installed via Flatpak, the package manager or an other conventional way, feel free to open an issue.

Make sure the application desktop file has a MimeType key that matches the type of resource you want it to handle. For example if you want the application ~/.local/share/applications/my-custom-browser.desktop to handle web content; add the following MimeType=text/html;text/xml;application/xhtml+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;.

The [Desktop Entry] of the .desktop file must be the first section as mandated by the specification.

The desktop filename should be unique. Junction can't display both /usr/share/applicatins/firefox.desktop and ~/.local/share/applications/firefox.desktop. The second overrides the first.

Finally - make sure to run update-desktop-database ~/.local/share/applications after installing a desktop file.

• System /usr/share/applications/
• User ~/.local/share/applications/
• Flatpak system /var/lib/flatpak/exports/share/applications/
• Flatpak user ~/.local/share/flatpak/exports/share/applications/
• Snap /var/lib/snapd/desktop/applications/

• Flathub
• Flathub repo
• Flathub builds
• Flathub stats
• Flathub API

# To update the pot file
# xgettext -f po/POTFILES -o po/re.sonny.Junction.pot --no-wrap -cTRANSLATORS --from-code=UTF-8
# sed -i "s/Project-Id-Version: PACKAGE VERSION/Project-Id-Version: re.sonny.Junction/" po/re.sonny.Junction.pot
meson compile re.sonny.Junction-pot -C build


# To create a translation
# msginit -i po/re.sonny.Junction.pot -o po/fr.po -l fr_FR.UTF-8
echo -n " fr" >> po/LINGUAS
meson compile re.sonny.Junction-update-po -C build

# To update translations
# msgmerge -U po/*.po po/re.sonny.Junction.pot
meson compile re.sonny.Junction-update-po -C build

See sonnyp/Commit#14 (comment)

• update metainfo and screenshot
• meson compile re.sonny.Junction-pot -C build
• meson compile re.sonny.Junction-update-po -C build
• Update version in meson.build
• git tag
• flathub