chore: merge dev into main (Linux build, AppImage, self-update)

Author: Orinks

.gitattributes

@@ -0,0 +1,7 @@
+# Allow Git to detect text files normally so diffs are generated and tools that
+# rely on textual patches (including PR automation) function correctly.
+* text=auto
+
+# AppImage launcher runs on Linux; a CRLF checkout would break its shebang.
+installer/appimage/AppRun text eol=lf
+installer/appimage/*.desktop text eol=lf

.github/workflows/build.yml

@@ -191,10 +191,160 @@ jobs:
           path: |
             dist/PortkeyDrop_macOS_*.zip
 
+  build-linux:
+    name: Linux
+    needs: prepare
+    if: needs.prepare.outputs.should_build == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 75
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.prepare.outputs.is_nightly == 'true' && 'dev' || github.ref }}
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+          cache: pip
+
+      - name: Restore Nuitka cache
+        uses: actions/cache/restore@v5
+        with:
+          path: .nuitka-cache
+          key: nuitka-${{ runner.os }}-py${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'installer/build_nuitka.py') }}-${{ github.run_id }}
+          restore-keys: |
+            nuitka-${{ runner.os }}-py${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'installer/build_nuitka.py') }}-
+            nuitka-${{ runner.os }}-py${{ env.PYTHON_VERSION }}-
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends \
+            ccache \
+            libgtk-3-dev \
+            libnotify-dev \
+            libsdl2-dev \
+            libwebkit2gtk-4.1-dev \
+            freeglut3-dev \
+            xvfb
+
+      - name: Install dependencies
+        run: |
+          WX_PYTHON_VERSION=4.2.5
+          PY_TAG=$(python -c 'import sys; print(f"cp{sys.version_info.major}{sys.version_info.minor}")')
+          pip install \
+            "https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-24.04/wxpython-${WX_PYTHON_VERSION}-${PY_TAG}-${PY_TAG}-linux_x86_64.whl"
+          pip install -e .[dev,build]
+
+      - name: Build
+        timeout-minutes: 55
+        run: |
+          python scripts/generate_build_meta.py ${{ needs.prepare.outputs.is_nightly == 'true' && needs.prepare.outputs.tag || '' }}
+          python installer/build_nuitka.py --tag "${{ needs.prepare.outputs.is_nightly == 'true' && needs.prepare.outputs.tag || '' }}"
+
+      - name: Smoke test packaged app
+        env:
+          XDG_DATA_HOME: ${{ runner.temp }}/portkeydrop-data
+          XDG_CONFIG_HOME: ${{ runner.temp }}/portkeydrop-config
+        run: |
+          set +e
+          timeout 25s xvfb-run -a dist/PortkeyDrop/PortkeyDrop > linux-smoke.log 2>&1
+          status=$?
+          set -e
+          cat linux-smoke.log
+          if grep -E "cannot register existing type 'G(Task|AsyncResult|InputStream|Seekable|PollableInputStream)'|GLib-GObject-CRITICAL" linux-smoke.log; then
+            echo "Packaged Linux app hit the GLib/GIO duplicate type-registration crash."
+            exit 1
+          fi
+          if [ "$status" -ne 0 ] && [ "$status" -ne 124 ]; then
+            echo "Packaged Linux app exited unexpectedly with status $status."
+            exit "$status"
+          fi
+
+      - name: Package AppImage
+        timeout-minutes: 15
+        run: python installer/build_appimage.py
+
+      - name: Smoke test AppImage on Fedora
+        timeout-minutes: 15
+        run: |
+          cat > fedora-smoke.sh <<'EOF'
+          set -e
+          dnf install -y -q gtk3 libnotify alsa-lib xorg-x11-server-Xvfb dejavu-sans-fonts >/dev/null
+          cd /work
+          appimage=$(find dist -maxdepth 1 -name 'PortkeyDrop_Linux_*.AppImage' -print -quit)
+          if [ -z "$appimage" ]; then
+            echo "AppImage was not created."
+            exit 1
+          fi
+          chmod +x "$appimage"
+          export XDG_DATA_HOME=/tmp/pkd-data XDG_CONFIG_HOME=/tmp/pkd-config
+          set +e
+          timeout 25s xvfb-run -a "$appimage" --appimage-extract-and-run > fedora-smoke.log 2>&1
+          status=$?
+          set -e
+          cat fedora-smoke.log
+          if grep -E "error while loading shared libraries|cannot open shared object file" fedora-smoke.log; then
+            echo "AppImage is missing a shared library on Fedora."
+            exit 1
+          fi
+          if grep -E "cannot register existing type 'G(Task|AsyncResult|InputStream|Seekable|PollableInputStream)'|GLib-GObject-CRITICAL" fedora-smoke.log; then
+            echo "AppImage hit the GLib/GIO duplicate type-registration crash on Fedora."
+            exit 1
+          fi
+          if [ "$status" -ne 0 ] && [ "$status" -ne 124 ]; then
+            echo "AppImage exited unexpectedly with status $status on Fedora."
+            exit "$status"
+          fi
+          echo "Fedora smoke test passed."
+          EOF
+          docker run --rm -v "$PWD:/work" fedora:43 bash /work/fedora-smoke.sh
+
+      - name: Verify Linux tarball avoids bundled OpenSSL
+        run: |
+          tarball=$(find dist -maxdepth 1 -name 'PortkeyDrop_Linux_*.tar.gz' -print -quit)
+          if [ -z "$tarball" ]; then
+            echo "Linux tarball was not created."
+            exit 1
+          fi
+          if tar -tzf "$tarball" | grep -E '(^|/)lib(ssl|crypto)\.so'; then
+            echo "Linux tarball must not bundle OpenSSL libraries; use the target system OpenSSL instead."
+            exit 1
+          fi
+
+      - name: Verify Linux tarball includes sound_lib x64 libraries
+        run: |
+          tarball=$(find dist -maxdepth 1 -name 'PortkeyDrop_Linux_*.tar.gz' -print -quit)
+          if [ -z "$tarball" ]; then
+            echo "Linux tarball was not created."
+            exit 1
+          fi
+          for lib in libbass.so libbassmix.so libbassopus.so libtags.so; do
+            if ! tar -tzf "$tarball" | grep -qx "PortkeyDrop/sound_lib/lib/x64/$lib"; then
+              echo "Linux tarball is missing sound_lib/lib/x64/$lib."
+              exit 1
+            fi
+          done
+
+      - name: Save Nuitka cache
+        if: always()
+        uses: actions/cache/save@v5
+        with:
+          path: .nuitka-cache
+          key: nuitka-${{ runner.os }}-py${{ env.PYTHON_VERSION }}-${{ hashFiles('pyproject.toml', 'installer/build_nuitka.py') }}-${{ github.run_id }}
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: linux
+          path: |
+            dist/PortkeyDrop_Linux_*.tar.gz
+            dist/PortkeyDrop_Linux_*.AppImage
+
   release:
     name: Release
-    needs: [prepare, build-windows, build-macos]
-    if: always() && needs.prepare.outputs.should_build == 'true' && (needs.build-windows.result == 'success' || needs.build-macos.result == 'success')
+    needs: [prepare, build-windows, build-macos, build-linux]
+    if: always() && needs.prepare.outputs.should_build == 'true' && (needs.build-windows.result == 'success' || needs.build-macos.result == 'success' || needs.build-linux.result == 'success')
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
@@ -220,20 +370,24 @@ jobs:
           TIMESTAMP=$(date -u +%Y%m%d)
 
           # Rename assets based on release type
-          for f in dist/*.exe dist/*.zip; do
+          for f in dist/*.exe dist/*.zip dist/*.tar.gz dist/*.AppImage; do
             [ -f "$f" ] || continue
             name=$(basename "$f")
             if [ "$IS_NIGHTLY" = "true" ]; then
               case "$name" in
                 *Setup*.exe) mv "$f" "assets/PortkeyDrop-nightly-${TIMESTAMP}-windows-setup.exe" ;;
                 *Portable*.zip) mv "$f" "assets/PortkeyDrop-nightly-${TIMESTAMP}-windows-portable.zip" ;;
                 *macOS*.zip) mv "$f" "assets/PortkeyDrop-nightly-${TIMESTAMP}-macOS.zip" ;;
+                *Linux*.tar.gz) mv "$f" "assets/PortkeyDrop-nightly-${TIMESTAMP}-linux.tar.gz" ;;
+                *Linux*.AppImage) mv "$f" "assets/PortkeyDrop-nightly-${TIMESTAMP}-linux-x86_64.AppImage" ;;
               esac
             else
               case "$name" in
                 *Setup*.exe) mv "$f" "assets/PortkeyDrop-${VERSION}-windows-setup.exe" ;;
                 *Portable*.zip) mv "$f" "assets/PortkeyDrop-${VERSION}-windows-portable.zip" ;;
                 *macOS*.zip) mv "$f" "assets/PortkeyDrop-${VERSION}-macOS.zip" ;;
+                *Linux*.tar.gz) mv "$f" "assets/PortkeyDrop-${VERSION}-linux.tar.gz" ;;
+                *Linux*.AppImage) mv "$f" "assets/PortkeyDrop-${VERSION}-linux-x86_64.AppImage" ;;
               esac
             fi
           done

CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+### Added
+- Linux builds: releases and nightlies now include a Linux tarball and an AppImage. The AppImage bundles the libraries missing on non-Ubuntu systems, so it runs on Fedora, Arch, and openSUSE too, while screen reader support, themes, and TLS keep using your distro's own libraries.
+- Linux AppImage installs can update themselves: the updater downloads the new AppImage, verifies its checksum, swaps it in place, and relaunches. Tarball runs get told where the verified download was saved instead of hitting a dead end.
+
+### Fixed
+- Pressing Delete or F2 while editing a text field no longer triggers file delete or rename — those keys now act only inside the file panes, and file operations tell you to focus a pane first instead of guessing (and sometimes targeting a remote file you never touched).
+- Background transfer completions no longer jump your position in the file lists back to the top; deletes and renames keep you on the nearest neighbouring file, and sorting or toggling hidden files keeps your selection.
+- The "Announce file count" setting now actually speaks the count when entering a directory; empty folders and empty filter results are announced instead of silent.
+- The Speech settings tab (rate, volume, verbosity) now controls the built-in speech output instead of doing nothing; verbosity also controls transfer progress announcements.
+- The "Verify host keys: ask" setting now really asks: connecting to an unknown SSH host shows an accessible dialog to reject or accept the key once or permanently, instead of silently trusting it.
+- The Cancel button on the update download progress dialog now actually cancels the download.
+- Upload, download, and transfer with nothing selected or no connection announce why nothing happened instead of doing nothing silently.
+- Restoring the window from the notification area and closing the transfer queue now place keyboard focus in the file list rather than on the window frame.
+- Removing a site in the Site Manager now asks for confirmation, announces the removal, and clears the form after the last site is deleted.
+- Repeated connect presses while a connection attempt is in progress no longer start duplicate attempts (and duplicate error dialogs). Starting a connection is now announced for screen readers.
+
+### Changed
+- The transfer queue window no longer opens (and steals focus) automatically every time a transfer is queued; announcements cover the feedback and Ctrl+Shift+T opens it on demand. Queue buttons disable without a selection, and the selection follows the same transfer when rows are removed.
+- Added Help > Keyboard Shortcuts listing every binding, including the previously undocumented F6, Ctrl+L, and Ctrl+1/2/3 pane shortcuts.
+- Duplicate menu and dialog access keys (Alt+letter) were reassigned so each letter activates its control directly across the menus, Site Manager, Settings, transfer queue, sound pack, and import dialogs.
+- The Settings Audio tab now scrolls so all mute checkboxes stay visible when focused; the file lists have proper accessible names for VoiceOver; keyboard-opened context menus appear at the focused file instead of the mouse pointer; switching protocol keeps a hand-typed port; the activity log no longer moves your reading position when new entries arrive; and a startup notice appears when no speech backend is available.
+
+### Changed
+- Pressing Escape in the quick connect bar while connected now hides the bar and returns focus to where you were.
+- Choosing Connect with an empty host, username, or required password now moves focus to the field that needs input and announces it, instead of showing a dead-end error dialog.
+- Quick Connect (Ctrl+N) now focuses the quick connect bar (revealing it while connected) instead of opening a separate dialog with the same fields.
+- Pressing Enter in any quick connect field now starts the connection, matching the old dialog behavior.
+- Removed the redundant File > Connect menu item; connecting lives in the quick connect bar and the Sites menu. Ctrl+Enter still connects.
+- Moved Disconnect from the File menu to the Sites menu, so connecting, disconnecting, and site management share one menu.
+- An invalid port in the quick connect bar now focuses the port field with an announcement instead of crashing the connect action.
+- Development builds now report the next 0.5.2 development version after the 0.5.1 hotfix release.
+
 ## [0.5.1] - 2026-05-31
 
 ### Fixed

PRD.md

@@ -108,7 +108,7 @@ Planned:
 - `Ctrl+Shift+N`: New directory
 - `Backspace`: Parent directory
 - `Enter`: Open directory / download file
-- `Ctrl+Q`: Disconnect
+- `Ctrl+Enter`: Connect using the quick connect bar
 - `Ctrl+I`: File properties
 - `Ctrl+T`: Transfer queue
 - `/` or `Ctrl+F`: Filter/search files

README.md

@@ -31,7 +31,7 @@ Portkey Drop includes a built-in default sound pack with short cues for transfer
 | Ctrl+I | File properties |
 | Ctrl+Shift+N | New directory |
 | Ctrl+Shift+T | Transfer queue |
-| Ctrl+Q | Disconnect |
+| Ctrl+Enter | Connect using the quick connect bar |
 | Enter | Open directory / download file |
 | Backspace | Parent directory |
 | Delete | Delete selected |
@@ -57,7 +57,9 @@ Saved connection passwords are stored in your system's secure keyring (Windows C
 
 ## Install
 
-Portkey Drop currently supports Python 3.11 and 3.12.
+Packaged builds for Windows (installer and portable ZIP), macOS, and Linux (tarball and AppImage) are published on the [releases page](https://github.com/Orinks/PortkeyDrop/releases). On Linux, download the AppImage, mark it executable (`chmod +x PortkeyDrop-*.AppImage`), and run it.
+
+To run from source instead, Portkey Drop currently supports Python 3.11 and 3.12.
 
 **Windows:**
 ```powershell

installer/appimage/AppRun

@@ -0,0 +1,7 @@
+#!/bin/bash
+# AppImage entry point. Bundled libraries live in usr/lib; the Nuitka dist
+# keeps its own layout under opt/portkeydrop with rpaths patched by
+# linuxdeploy to reach usr/lib.
+HERE="$(dirname "$(readlink -f "$0")")"
+export LD_LIBRARY_PATH="$HERE/usr/lib${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"
+exec "$HERE/opt/portkeydrop/PortkeyDrop" "$@"

installer/appimage/portkeydrop.desktop

@@ -0,0 +1,8 @@
+[Desktop Entry]
+Type=Application
+Name=PortkeyDrop
+Comment=Keyboard-first file transfer client for SFTP, FTP, FTPS, and WebDAV
+Exec=PortkeyDrop
+Icon=portkeydrop
+Categories=Network;FileTransfer;
+Terminal=false

installer/appimage/portkeydrop.png

@@ -24,6 +24,7 @@
 import shutil
 import subprocess
 import sys
+import tarfile
 from pathlib import Path
 
 if hasattr(sys.stdout, "reconfigure"):
@@ -433,10 +434,6 @@ def create_portable_zip() -> bool:
 
     zip_path = DIST_DIR / zip_name
 
-    # Remove existing zip
-    if Path(f"{zip_path}.zip").exists():
-        Path(f"{zip_path}.zip").unlink()
-
     if IS_WINDOWS:
         (source_dir / ".portable").write_text("1\n", encoding="utf-8")
         (source_dir / "data").mkdir(exist_ok=True)
@@ -447,9 +444,22 @@ def create_portable_zip() -> bool:
             print(f"Error: {exc}")
             return False
 
-    shutil.make_archive(str(zip_path), "zip", source_dir.parent, source_dir.name)
+    if IS_LINUX:
+        # tar.gz keeps the executable bit on the launcher, unlike zip.
+        archive_file = Path(f"{zip_path}.tar.gz")
+        if archive_file.exists():
+            archive_file.unlink()
+
+        with tarfile.open(archive_file, "w:gz") as archive:
+            archive.add(source_dir, arcname=source_dir.name)
+    else:
+        archive_file = Path(f"{zip_path}.zip")
+        if archive_file.exists():
+            archive_file.unlink()
+
+        shutil.make_archive(str(zip_path), "zip", source_dir.parent, source_dir.name)
 
-    print(f"\n✓ Portable ZIP created: {zip_path}.zip")
+    print(f"\n✓ Portable archive created: {archive_file}")
     return True