Skip to content

feat: add Linux desktop launcher for dev builds#5076

Open
hobson wants to merge 1 commit into
ankitects:mainfrom
totalgood:master
Open

feat: add Linux desktop launcher for dev builds#5076
hobson wants to merge 1 commit into
ankitects:mainfrom
totalgood:master

Conversation

@hobson

@hobson hobson commented Jun 29, 2026

Copy link
Copy Markdown

Adds tools/anki-dev.desktop with an ANKI_SRC placeholder and install instructions in README.md for XDG-compatible desktops (GNOME, KDE, etc.).

Linked issue (required)

Fixes #5075

Summary / motivation (required)

Adds tools/anki-dev.desktop with paramaterized ANKI_SRC path for configuration by developer/tester wishing to integrate a pre-release dev version of the Anki app with their Desktop for testing or daily use.

Steps to reproduce (required, use N/A if not applicable)

N/A

How to test (required)

Compile with just run and then follow the newly added instructions in updated README.md section ### Linux Desktop Integration:

# From the repo root
sed "s|ANKI_SRC|$(pwd)|g" tools/anki-dev.desktop \
    > ~/.local/share/applications/anki-dev.desktop
update-desktop-database ~/.local/share/applications/

Open your app grid, find Anki (dev), and launch, pinning it to your toolbar or right click and "Add to Favorites" to verify it launches correctly and is integrated with your particular XDG-compatible Linux Desktop. To verify live (--editable) install, add a new feature and recompile before launching and testing the "Anki (dev)" desktop app.

Checklist (minimum)

  • I ran just check
  • Could not identify a new test.

Details

Works as expected on Ubuntu 26.04:

  • Launches from the ⊞ or "app grid" keyboard key then "Anki"
  • Pinnable icon is shown in the Taskbar/Toolbar after launch

After installing Anki (dev) with this Desktop file, and updating the Software Registry in Ubuntu 26.04 (see new README.md section), the Software Manager (gnome-software) does not list Anki (dev) under the "Installed" tab, but rather the released "Anki" app which has not been installed. Clicking on that app redirects to the Install link for the Flatpack/release version.

Before / after behavior (optional)

N/A

Risk / compatibility / migration (optional)

N/A (developer-only feature)

UI evidence (required for visual changes; otherwise N/A)

image image

Scope

  • This PR is focused on one change (no unrelated edits).

Adds tools/anki-dev.desktop with an ANKI_SRC placeholder and install
instructions in README.md for XDG-compatible desktops (GNOME, KDE, etc.).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 Anki | 🛠️ Build #33362238 | 📁 Comparing d007fdd against latest (b00308e)

  🔍 Preview build  

1 file changed
± index.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat (dev tooling): Add an "Anki (dev)" .desktop file to complete dev app install on Ubuntu, Mint, etc.

1 participant