Skip to content

feat: add AppImage build for Linux#13

Merged
rodrigogs merged 3 commits into
devfrom
copilot/add-appimage-build-support
Dec 19, 2025
Merged

feat: add AppImage build for Linux#13
rodrigogs merged 3 commits into
devfrom
copilot/add-appimage-build-support

Conversation

Copilot AI commented Dec 19, 2025

Copy link
Copy Markdown
Contributor
  • Add AppImage target to Linux build configuration in package.json
  • Update .github/workflows/build.yml to upload AppImage artifacts to releases
  • Update RELEASE.md to reflect AppImage support (removed outdated removal note, updated build counts)
  • Update all README translations (10 languages) with AppImage download instructions
Original prompt

This section details on the original issue you should resolve

<issue_title>Request: AppImage build</issue_title>
<issue_description>Hello there,
thanks for creating this tool! I tested it out and I'm amazed at how well it works. I'm looking forward to it's continued development, applying date ranges or viewing the media gallery comes to mind. But I want to raise something else:

I'm using Arch Linux, so neither the .deb nor the .rpm build suits me natively. Would you consider providing an AppImage build? That would make it compatible with most Linux flavors. :)

For now I've used debtap and manually removed its dependency on the gtk package (with gtk4 still required) and that works great. Lowering the barrier to entry would still be preferred I think. :)

Thanks again for developing this! </issue_description>

<agent_instructions>Create a PR from the already created branch and start investigating the user suggestion.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@rodrigogs Thank you for the feedback, it's so great to notice that people like it!

I will install an Arch VM to test it and it will be available soon, I promise :)

For now you can use it on your browser with no drawbacks.</comment_new>


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: rodrigogs <2362425+rodrigogs@users.noreply.github.com>
Copilot AI changed the title [WIP] Add AppImage build for Linux compatibility feat: add AppImage build for Linux Dec 19, 2025
Copilot AI requested a review from rodrigogs December 19, 2025 20:14
@rodrigogs rodrigogs requested a review from Copilot December 19, 2025 20:16

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR re-introduces AppImage builds for Linux distributions, addressing a user request for better compatibility with Arch Linux and other distros that don't natively support .deb or .rpm formats. AppImage was previously removed in v1.13.4 due to CDN reliability issues, but is being re-added by user request.

Key changes:

  • Added AppImage as a build target for Linux in the Electron builder configuration (x64 and arm64 architectures)
  • Updated CI/CD workflow to include AppImage files in release assets and build artifacts

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
package.json Added AppImage target to Linux build configuration with x64 and arm64 architecture support
.github/workflows/build.yml Added *.AppImage glob patterns to both release upload and artifact upload steps

The implementation is technically sound and follows the exact same pattern as the existing deb and rpm targets. The JSON structure in package.json is valid and consistent with other platform configurations. The workflow changes ensure AppImage files will be properly included in both GitHub releases and CI artifacts.

Note: While not part of this PR's scope, project maintainers should consider updating:

  • RELEASE.md which still contains documentation stating AppImage was removed due to unreliable CDN downloads
  • README files across all languages which currently list "Linux (AppImage, deb)" but should be updated to "Linux (deb, rpm, AppImage)" for accuracy

@rodrigogs

Copy link
Copy Markdown
Owner

@copilot

RELEASE.md which still contains documentation stating AppImage was removed due to unreliable CDN downloads
README files across all languages which currently list "Linux (AppImage, deb)" but should be updated to "Linux (deb, rpm, AppImage)" for accuracy

Update it.

Co-authored-by: rodrigogs <2362425+rodrigogs@users.noreply.github.com>

Copilot AI commented Dec 19, 2025

Copy link
Copy Markdown
Contributor Author

@copilot

RELEASE.md which still contains documentation stating AppImage was removed due to unreliable CDN downloads
...

Updated in 798e592:

  • RELEASE.md: Removed outdated note about AppImage removal, updated build diagrams and file counts
  • All 10 README translations: Added AppImage download instructions for "Other distros (Arch, etc.)" and updated build command comments to Linux (deb, rpm, AppImage)

@rodrigogs rodrigogs marked this pull request as ready for review December 19, 2025 20:32
@rodrigogs rodrigogs merged commit 281927e into dev Dec 19, 2025
4 checks passed
@rodrigogs rodrigogs deleted the copilot/add-appimage-build-support branch December 19, 2025 20:32
rodrigogs added a commit that referenced this pull request Apr 1, 2026
Correctness:
- #1: handleRemoveChat now removes from UI first (sync), cleans up
  IndexedDB in background to avoid stale index issues
- #2: Remove redundant double-store of FileSystemFileHandle
  (savePersistedChat already handles it)
- #3: Restored chats now populate chatFileReferences with persistedId
  to prevent orphaned duplicates on toggle

Security:
- #4: Use file descriptor with O_NOFOLLOW to prevent TOCTOU race
  in Electron file read IPC

DRY:
- #5: Extract LoadingChat interface to shared state.svelte.ts
- #6: getBookmarksForChatAsExport delegates to getBookmarksForChat
- #7: Extract sanitizeFilename helper to format.ts
- #8: formatDate kept local (locale-aware, not extractable)
- #9: Add addRemembered/removeRemembered helpers (5 call sites)

i18n/Accessibility:
- #10: Add aria-label to ReselectFileModal drop zone
- #11: i18n Modal close label across 10 locales

Clean Code:
- #12: Split handleToggleRemember into rememberChat/forgetChat
- #13: Toast uses Icon component instead of inline SVGs
rodrigogs added a commit that referenced this pull request Apr 1, 2026
Correctness:
- #1: handleRemoveChat now removes from UI first (sync), cleans up
  IndexedDB in background to avoid stale index issues
- #2: Remove redundant double-store of FileSystemFileHandle
  (savePersistedChat already handles it)
- #3: Restored chats now populate chatFileReferences with persistedId
  to prevent orphaned duplicates on toggle

Security:
- #4: Use file descriptor with O_NOFOLLOW to prevent TOCTOU race
  in Electron file read IPC

DRY:
- #5: Extract LoadingChat interface to shared state.svelte.ts
- #6: getBookmarksForChatAsExport delegates to getBookmarksForChat
- #7: Extract sanitizeFilename helper to format.ts
- #8: formatDate kept local (locale-aware, not extractable)
- #9: Add addRemembered/removeRemembered helpers (5 call sites)

i18n/Accessibility:
- #10: Add aria-label to ReselectFileModal drop zone
- #11: i18n Modal close label across 10 locales

Clean Code:
- #12: Split handleToggleRemember into rememberChat/forgetChat
- #13: Toast uses Icon component instead of inline SVGs
rodrigogs added a commit that referenced this pull request Apr 1, 2026
…storation (#66)

* feat: add persistent conversation feature with cross-platform file restoration

Implement "Remember Conversation" toggle that persists chat sessions
across app restarts using IndexedDB (idb-keyval). Three platform
strategies: Electron file paths, Chromium FileSystemFileHandle, and
fallback reselect for Firefox/Safari.

New components: RestoreSessionModal, ReselectFileModal, Toast, Modal.
Stores metadata, bookmarks, transcriptions, settings (~1MB).
Never stores the ZIP file itself.

* fix: resolve all 15 type errors in persistent conversations feature

- Add File System Access API type declarations (FileSystemHandlePermissionDescriptor,
  OpenFilePickerOptions, FileSystemFileHandle augmentation, Window.showOpenFilePicker)
  to the global scope in src/app.d.ts
- Register 7 missing icon names (alert-circle, folder, clock, check-all, x,
  check-circle, message-circle) in the Icon component with SVG path definitions
- Add missing isElectronPathReference import in +page.svelte, which also resolves
  the union type narrowing error for filePath access

* fix(electron): harden file:readFromPath IPC handler

- Restrict to .zip files only to prevent path traversal attacks
- Use async fs.promises.readFile() instead of blocking readFileSync()
- Properly slice Buffer to ArrayBuffer using byteOffset/byteLength

* fix(i18n): replace hardcoded English strings with Paraglide messages

Replace hardcoded strings in RestoreSessionModal ("Select All",
"Deselect All") and ReselectFileModal ("Drop WhatsApp ZIP file here",
"or click below to browse", "Browse Files") with proper Paraglide i18n
message calls. Added translations for all 10 supported languages.

* fix(persistence): clean up IndexedDB entries when removing a remembered chat

When a user removed a chat via handleRemoveChat(), persisted data in
IndexedDB was not cleaned up, leaving orphaned entries that caused the
restore modal to show stale chats. Now handleRemoveChat checks if the
chat is in rememberedChats and, if so, finds and removes the persisted
entry from IndexedDB before removing it from UI state.

* fix(persistence): add error logging to silent catch blocks

Add console.error/warn logging to five catch blocks in
persistence.svelte.ts that were silently swallowing errors, making
IndexedDB issues impossible to debug.

* fix(ReselectFileModal): eliminate drag-drop flicker with counter pattern

Replace boolean isDragging state with dragCounter pattern to fix visual
flicker that occurred when dragging files over nested elements. The counter
increments on dragenter and decrements on dragleave, preventing the rapid
toggling that caused the flicker.

* chore: remove AI handoff document

* fix: clean up dead code, timer leaks, and unused imports

* fix: resolve critical bugs and extract duplicated parse/index logic

- Fix C2: restore loop now awaits user reselect via Promise pattern
  instead of continuing to next chat immediately
- Fix C1: add one-time guard to $effect for persistence check
- Fix C3: harden Electron file read with path normalization and
  symlink protection (lstat check)
- DRY: extract startIndexWorker() and makeProgressCallback() from
  ~150 lines of duplicated code between handleFilesSelected and
  loadChatFromBuffer

* fix: address final review items

- Replace remaining hardcoded English strings with i18n messages
- Filter transcriptions to only include current chat's message IDs
  when persisting (prevents cross-chat data leakage)
- Add translations for new keys to all 9 non-English locales
- Document chatFileReferences intentional non-reactive mutation

* fix: translate all persistence keys and remove dead isRestoring state

* refactor: deduplicate getBookmarksForChatAsExport

* fix(electron): use file descriptor to prevent TOCTOU race in file read

* refactor(Toast): replace inline SVGs with Icon component

Replace inline SVG elements with the reusable Icon component for better code maintainability and consistency. The status icon now uses check-circle for success and alert-circle for error/info types, while the close button uses the x icon.

* fix(a11y): add aria-label to drop zone and i18n Modal close label

- Add aria-label to drop zone in ReselectFileModal for screen reader accessibility
- Replace hardcoded 'Close modal' string with i18n key close_modal in Modal component
- Add close_modal translations to all 10 locale files (en, pt, es, fr, de, it, nl, ja, zh, ru)

* refactor: address all 13 review items

Correctness:
- #1: handleRemoveChat now removes from UI first (sync), cleans up
  IndexedDB in background to avoid stale index issues
- #2: Remove redundant double-store of FileSystemFileHandle
  (savePersistedChat already handles it)
- #3: Restored chats now populate chatFileReferences with persistedId
  to prevent orphaned duplicates on toggle

Security:
- #4: Use file descriptor with O_NOFOLLOW to prevent TOCTOU race
  in Electron file read IPC

DRY:
- #5: Extract LoadingChat interface to shared state.svelte.ts
- #6: getBookmarksForChatAsExport delegates to getBookmarksForChat
- #7: Extract sanitizeFilename helper to format.ts
- #8: formatDate kept local (locale-aware, not extractable)
- #9: Add addRemembered/removeRemembered helpers (5 call sites)

i18n/Accessibility:
- #10: Add aria-label to ReselectFileModal drop zone
- #11: i18n Modal close label across 10 locales

Clean Code:
- #12: Split handleToggleRemember into rememberChat/forgetChat
- #13: Toast uses Icon component instead of inline SVGs

* fix: address all 9 Copilot review comments

1. Capture Electron file.path from drag-drop for persistence
2. Block metadata restoration when file validation fails
3. Deduplicate savePersistedChat (removes existing entry first)
4. Filter transcriptions by chat message IDs (prevents cross-chat leak)
5. Case-insensitive .zip check in ReselectFileModal
6. Clamp dragCounter to 0 minimum
7. Use isAbsolute + reject .. segments for Electron path validation
8. Guard error.message with instanceof Error check
9. Add keyboard/click handlers to drop zone for accessibility

* fix: address 3 new Copilot review comments

- Seed rememberedChats from IndexedDB on load so toggle state is
  correct even when user skips restore modal or clicks Start Fresh
- Fix verifyHandlePermission docstring to reflect shouldRequest param
- Use chatId+messageId composite key for bookmark import dedup to
  prevent cross-chat bookmark collisions

* fix: capture FileSystemFileHandle during drag-drop for seamless persistence

- Use DataTransferItem.getAsFileSystemHandle() during drop event to
  capture handles without showing a second file picker (Chrome 86+)
- Remove promptForFileHandle() call from rememberChat — handles are
  now captured at drag-drop time, eliminating the confusing double-
  file-picker UX
- Update reselect flow to capture Electron file.path and update the
  persisted entry so future restores work automatically
- Add DataTransferItem.getAsFileSystemHandle type declaration

* fix: capture file handles synchronously during drop and fix closure bug

- Start all getAsFileSystemHandle() Promises synchronously via
  Promise.all before any await, preventing DataTransferItem
  invalidation after first async tick
- Capture handleIndex and file path BEFORE the async IIFE to avoid
  closure-over-loop-variable bug where stale index was read after
  multiple awaits

* fix: pass Electron file path from dialog to persistence layer

The Electron file picker (openFile dialog) returns the absolute path
but it was discarded when creating the File object from the buffer.
This caused all Electron-picked files to be stored as
'reselect-required' instead of 'electron-path', forcing manual
reselection on every restore.

Now FileDropZone passes the path from Electron's dialog result via
a new 'paths' callback parameter. handleFilesSelected prefers this
explicit path over file.path (drag-drop fallback).

* debug: add persistence flow logging to trace Electron path issue

* fix: address 4 Copilot review comments

- Toast: reset visibility and restart timer when message prop changes
- FileDropZone: use showOpenFilePicker() on Chrome for file input to
  capture FileSystemFileHandle (drag-drop already captures handles;
  this fixes the regular "click to browse" flow)
- Remove unused isFileSystemAccessSupported import from +page.svelte
- Electron dialog path already fixed (result.path passed via paths
  callback parameter)

* fix: address 3 Copilot review comments

- Electron IPC: add lstat pre-check for cross-platform symlink
  rejection (O_NOFOLLOW not supported on Windows), with graceful
  fallback to O_RDONLY when O_NOFOLLOW unavailable
- FileDropZone: enable multi-select in showOpenFilePicker to match
  the existing <input multiple> behavior
- CSS: use :where(button) for low-specificity cursor rule so Tailwind
  utilities can override it

* fix: ReselectFileModal uses Electron dialog to capture file path

The reselect modal was using the web file input which doesn't
capture the absolute file path in Electron. Now uses the Electron
native dialog (electronAPI.openFile) which returns the path, and
passes it through to updatePersistedChat so the entry is upgraded
from 'reselect-required' to 'electron-path'. After one reselect,
future restores work automatically.

* fix: move Remember Conversation above Transcription Language in context menu

* fix: ReselectFileModal captures FileSystemFileHandle on Chrome and upgrades persisted entries

The reselect modal was using plain <input type=file> on Chrome,
which doesn't capture a FileSystemFileHandle. This meant even after
reselecting, the entry stayed as 'reselect-required' and the user
would be prompted again on every restart.

Now:
- Chrome/Edge: uses showOpenFilePicker() to capture a handle, then
  upgrades the persisted entry from 'reselect-required' to
  'file-handle' via storeFileHandle + updatePersistedChat
- Electron: uses native dialog to capture path, upgrades to
  'electron-path'
- Drag-drop in reselect modal also captures handle via
  getAsFileSystemHandle()

After one reselect, future restores work automatically on all
platforms.

* fix: removing chat from list no longer deletes persisted data

Removing a chat only clears it from the current session. Persisted
data in IndexedDB is preserved so the chat reappears in the restore
modal on next launch. To permanently forget a chat, user must toggle
Remember Conversation off.

* chore: remove debug logging from persistence flow

* fix: sidebar import uses Electron dialog and captures file path

The sidebar "Import chat" button was using a plain <input type=file>
which doesn't reliably provide file.path in Electron. Now uses the
same platform-aware import as the main drop zone:
- Electron: native dialog via electronAPI.openFile() with path capture
- Chrome/Edge: showOpenFilePicker() with handle capture
- Fallback: regular file input

Also fixes Node.js Buffer pool issue in dialog:openFile handler
(was sending entire shared ArrayBuffer instead of just the file's
portion).

* refactor: address all review items - dead code, DRY, a11y, error feedback

- Replace dynamic import of storeFileHandle with static import
- Remove 6 unused i18n keys from all 10 locale files
- Remove dead exports: promptForFileHandle, getPersistedChat, getBookmarksForChatAsExport
- Add error toast on restore failure in handleRestoreChats
- Extract shared file-picker helpers (openZipFilePicker, openElectronFile, getElectronFilePath)
- Add aria-label to FileDropZone drop zone
- Rename persistence_close_notification to close_notification in Toast

* refactor: centralize modals, fix cross-chat ID collisions, address review feedback

- Extract ChatAvatar component replacing 3 inline avatar implementations
- Add shared formatRelativeDate helper (label/compact modes)
- Add Button size="lg" variant with disabled styles
- Vertically center Modal on all breakpoints, not just desktop
- RestoreSessionModal: remove description banner, only chat list scrolls,
  fixed footer with action buttons
- Fix message ID collisions across chats by including filename in hash
- Fix Toast timer not restarting when message changes while visible
- Gate reselect flow: only upgrade persisted entry when validation passes
- Add persistence_restore_failed i18n key across all 10 locales
- Remove unused isFileSystemAccessSupported import and function

---------

Co-authored-by: Rodrigo Gomes da Silva <rodrigo.smscom@gmail.com>
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.

Request: AppImage build

3 participants