Dzurkel v1.0.0

Dzurkel 1.0.0 — Progressive file previews

Select a file, press Space, inspect it and dismiss it. This release brings progressive loading and direct source access to large files while keeping Dzurkel a lightweight, read-only previewer.

Release validation is running. This prerelease was recreated at verified commit 4773ddc. The Qt 6.4 PDF compatibility expectation and synthetic input-device teardown defects in the tests are corrected. Before publication, this exact committed source passed all 26 real Debian 12 / Qt 6.4.2 baseline targets and the PDF suite on Qt 6.11.2. Runtime installers will appear after the package, clean-install and native GNOME checks pass. Stable promotion remains pending those gates and asset verification.

Changes since 0.9.0

• Text, logs and source code: load portions as you scroll, with bounded caches and backward navigation. End / Ctrl+End seeks to the actual last portion, including large SQL exports; Ctrl+Home returns to the start.
• CSV/TSV and XLSX: load complete row batches incrementally. XLSX retains worksheet selection, saved values and existing formula-result notices.
• Documents and books: DOCX, DOC, RTF, EPUB, FB2, SFB, MOBI 6 and Markdown continue through the shared rich-document view, preserving supported formatting and reading position.
• Direct sources: remove unconditional whole-file staging and whole-source-size admission caps for these readers, PDFs and images. PDF pages render on demand; image decoding runs in isolated helpers. Content, parser, image, cache and work budgets remain in place.
• Responsiveness and lifecycle: bound image-format probing, reject obsolete asynchronous results, and cancel/disarm resource-preparation, folder-navigation and media requests before nonwaiting process-wrapper detachment at application exit. Normal helper limits and asynchronous reaping remain unchanged.
• Video window sizing: fit the detected display aspect ratio plus playback controls within the screen, once per preview. Later seeking and metadata preserve manual resizing; maximized and fullscreen windows retain their state.

Existing Dolphin, Nautilus, Thunar and optional KDE file-dialog integrations remain available. Optional media, highlighting, folder-size and legacy DOC dependencies stay optional. No new mandatory parser, transport or rendering framework is introduced.

Validation

• The earlier full host run passed all 35 CTest targets, including 28 isolated shutdown regression cases and generated landscape/portrait video tests.
• The final committed correction passed 26/26 baseline targets on actual Qt 6.4.2 (80.86 s), plus the PDF suite on Qt 6.11.2 (5.73 s). The preceding isolated audit also repeated the corrected Qt 6.4 PDF suite three times with clean exits.
• PDF page rendering remains available on Qt 6.4/6.5; clickable PDF links require Qt 6.6+. The baseline tests verify empty-link fallback and ordinary navigation, while newer-Qt tests retain real link clicking.
• The user confirmed the updated application's video sizing in Ubuntu and Arch Linux VMs.
• Real-file acceptance included a 3.8 GB SQL dump with immediate end navigation and subsequent lazy loading, and an approximately 78 GB MKV with responsive random-position playback over SMB. These are individual user observations, not controlled latency or cold-cache benchmarks.

Earlier progressive-reader, sanitizer and desktop results are recorded with their actual build versions in the validation record. Tagged package and desktop pipeline results will be added after completion.

Scope and known limits

Dzurkel remains a quick previewer. Selection/copy covers resident content; there is no full-file search, editor or document-layout engine. Very distant structured replay, large indivisible blocks and eager metadata can exceed reader budgets. Markdown reference discovery can scan ahead within its work allowance. Highlighting can lose multiline context whose opening text was evicted.

An earlier Ubuntu GNOME EPUB check observed a one-pixel continuation-anchor discrepancy. Direct SFTP remains experimental and disabled by default. Kernel-blocked filesystem I/O can delay helper termination; the shutdown fix avoids waiting for its process wrapper, rather than promising immediate kernel termination. Application budgets are not an OS memory sandbox.

Install or upgrade

Validated runtime packages will be attached here:

Target	Installer
Fedora 44, x86_64	dzurkel-1.0.0-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_1.0.0-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-1.0.0-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside your installer and run sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned; checksums verify integrity, not signatures.

Quit the resident process before upgrading the executable and matching adapters. Installation does not enable or rewrite file-manager shortcuts. See the installation guide and full release notes.

Full comparison: v0.9.0...v1.0.0

Dzurkel v0.9.0 — Folder and KDE dialog previews

Dzurkel 0.9.0 — Folder information and KDE dialog previews

Status: release validation passed, all three runtime installers and
SHA256SUMS are attached, and 0.9.0 has been promoted to latest stable.

Changes since 0.8.0

• Folder previews show contents size and file/subfolder counts asynchronously,
  replacing the misleading directory-entry size, often 4 KiB. Progress, Stop,
  partial results and a 30-second deadline keep slow calculations explicit.
• Optional desktop calculators reuse KIO on KDE and GIO on GNOME/XFCE. Older
  KIO counters that include directory metadata are excluded. Missing or
  incompatible modules leave basic folder information and other previews usable.
• Thunar's Space and context-menu action supports one selected local file or
  folder. Existing managed setups offer Update folder previews… in Settings;
  migration preserves original restore backups, shortcuts and unrelated actions.
• An optional KDE file-dialog adapter adds Space previews to compatible native
  KFileWidget choosers, including KDE portal dialogs used by applications.
  Enable its separate session-wide opt-in in Settings and sign out/in.
  Caller ownership and focus/dismissal handling keep chooser previews scoped
  to the dialog that opened them.
• Additional media tests cover source failure, recovery and cancellation. Test
  SFTP preferences are isolated from the developer's normal settings.
• Documentation now includes a clearer setup/compatibility guide and a video
  demonstration recorded with 0.8.0; video playback itself was added in 0.8.0.

Validation and limits

The 0.9.0 release workflow
passed Fedora GCC/RPM and Clang tests, Debian and Arch package builds, all three
clean install/launch/removal checks, the Debian 12 baseline and native GNOME
Wayland/Nautilus input, focus and rendered-placement checks. The attached
runtime installers were downloaded and verified against SHA256SUMS before
stable promotion. These gates do not establish every desktop or backend case.

Fedora KDE's folder implementation was smoke-tested by the user. Ubuntu GNOME
passed 27 suites; the Arch package passed 30 suites and fresh-runtime checks
without KIO/CoreAddons. Both VM installations displayed exact generated folder
totals in native sessions. Normal-session Thunar folder Space/Escape passed
after upgrading its existing managed action. The optional-adapters-off baseline
passed 21 suites. These VM builds preceded the final 0.9.0 version bump; see
the testing record
for the final source checks. After the version
bump, the local all-adapters build passed 30/30 suites and the baseline passed
21/21; both executables report 0.9.0.

GIO and KIO retain their desktop APIs' different link/count semantics. GIO counts
hard-link entries separately and symlink text without following targets; its
measurement excludes nested filesystem mounts. No custom recursive scanner,
filesystem snapshot or persistent size cache is introduced. Real-share timing,
authentication, disconnection and cancellation still need targeted acceptance.

KDE dialog coverage depends on applications loading the optional Qt adapter.
It does not establish support for every chooser, toolkit or desktop, and stock
GNOME/GTK choosers are not covered by that adapter. The user previously confirmed
the Fedora KDE adapter smoke test; browser upload dialogs were not retested in
the folder-sizing VM run.

Upgrading

The validated assets are attached to the
GitHub release:

System	Installer
Fedora 44, x86_64	dzurkel-0.9.0-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_0.9.0-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-0.9.0-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside the installer and run
sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned;
checksums verify integrity and are not signatures. Follow the
installation guide
for your package manager's commands.

Quit the resident process before replacing the executable and matching adapters.
Folder calculation needs no login opt-in; KDE dialog integration does.
Existing Thunar users should apply Update folder previews… in Settings,
finishing file operations before accepting a restart. Installation alone does
not change shortcuts.

See folder behavior,
KDE file dialogs,
Thunar setup
and release validation.

Dzurkel v0.8.0

Dzurkel 0.8.0 — Now with video previews

Status: release validation passed, installers are attached, and 0.8.0 has
been promoted from prerelease to the latest stable release.

Dzurkel brings Quick Look-style file previews to Linux, with integration for
Dolphin, Nautilus and Thunar. Select a file and press Space after enabling the
shortcut in Dzurkel Settings.

Version 0.8.0 adds video playback, joining images, PDFs, documents,
spreadsheets, e-books, source code and audio in one reusable preview window.
Play, pause, seek where supported, and carry your mute/volume choices between
music and video. Common containers include MP4, MKV, WebM, MOV and AVI;
playback depends on installed multimedia backends and codecs.

Media is read incrementally, with bounded source read-ahead for slow shares,
without creating a whole-file temporary snapshot. Dzurkel remains read-only,
with optional backends for additional capabilities.

Native package targets are Fedora 44, Debian 13 and current Arch Linux.
Installers are available below following successful release validation. See the
detailed validation limits before choosing a package.

Changes since 0.7.1

• Preview MP4/M4V, MKV, WebM, MOV, AVI, MPG/MPEG, OGV and WMV in an
  aspect-preserving video view. Playback depends on installed Qt media backends
  and codecs; a filename or container does not guarantee decoding support.
• Audio and video autoplay with sound and share the running session's mute and
  volume choices. Play/pause uses P; Space/Escape continue to dismiss.
  Timeline controls support seeking when the source/backend permits it.
• Actual media tracks choose the music or video view without reopening the
  source, preserving audio-only MP4 support and music cover-art presentation.
• Local files and mounted shares use the existing isolated file-reading helper.
  A fixed 512 KiB read-ahead window reduces repeated filesystem reads, while
  IPC transfers stay at most 64 KiB. Dzurkel creates no whole-file media snapshot.
• Loading waits for a valid video frame. Slow reads and seeks receive explicit
  feedback, and closing/changing previews cancels source access independently
  of its read deadline. Old playback errors cannot replace a newer preview.
• Incompatible media adapters now report their interface mismatch and the
  need to reinstall a matching application/adapter set, rather than “Unknown error.”
• Plain text wraps to the preview width by default. Wrap lines in the
  toolbar remembers the user's choice without modifying whitespace or files.
• Settings adds OS compatibility…, showing the build's requirements and
  distinguishing reviewed dependency candidates from validated OS support.
• Debian packages recommend the audio/video runtime libraries alongside
  highlighting. Development SDKs are needed only when building; the adapters
  remain optional at runtime and baseline previews still work without them.

Downloads and upgrading

The validated runtime installers and checksum manifest are attached to the
GitHub release.

System	Installer
Fedora 44, x86_64	dzurkel-0.8.0-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_0.8.0-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-0.8.0-1-x86_64.pkg.tar.zst

# Fedora
sudo dnf install ./dzurkel-0.8.0-1.fc44.x86_64.rpm

# Debian 13
sudo apt install ./dzurkel_0.8.0-1_amd64.deb

# Arch Linux: update first, then install
sudo pacman -Syu
sudo pacman -U ./dzurkel-0.8.0-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside the installer and verify with
sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned; checksums
verify integrity and are not signatures. No Dzurkel update repository is provided.

Quit the resident Dzurkel process before upgrading and restart it afterward so
the executable and optional adapters match. Preferences and integration backups
are preserved. A user-local development executable can shadow a system package;
follow the installation guide when switching between them. Dolphin Space setup
still requires Dolphin 26.04 or newer. Ubuntu is a development-test platform,
not a release DEB target; choose a package built for your distribution/release.

Validation and known limits

Development validation includes the full local CTest suite, focused media
ASan/UBSan checks, generated silent video and audio-only MP4 fixtures, front/tail
MP4 indexes, MKV/WebM playback, delayed reads, seek-to-end, repeated teardown and
missing/incompatible adapter checks. Read-only local and mounted-CIFS samples
passed integrated native KDE Wayland checks; an actual compositor capture was
visually inspected. See the testing record for the versioned release checks.

Per-read latency injection improved seek behavior with bounded read-ahead, but
does not establish cold-cache bandwidth performance or real network-disconnection
recovery. Codec/backend coverage, actual missing-audio-device playback, full
GNOME/XFCE video acceptance and hard decoder/GPU memory bounds remain separate
checks. Automatic reconnect/resume, playlists and advanced subtitle/track
controls are outside this release. Public HTTP/live-stream URLs are not added.

The 0.8.0 release workflow
passed package builds and tests, all three clean install/removal checks, the
Debian 12 baseline and the native GNOME gate. Installers were attached before
stable promotion. These checks retain the desktop/codec limitations above;
passing CI does not establish every hardware or desktop configuration.

See video behavior,
testing,
installation
and runtime compatibility.

Dzurkel v0.7.1

Dzurkel 0.7.1 adds clearer Settings and optional-library recovery, fixes preview
opening behavior, and introduces the Dzurkel application icon.

Changes since 0.7.0

• Settings now has Integration, Previews and Libraries tabs, with
  preview formats grouped by type and supported formats listed in information popups.
• Libraries reports component availability, explains missing readers and offers
  copyable installation commands for reviewed distributions. Dzurkel does not run
  package installers or enable repositories. Highlighting has a persistent checkbox.
• Audio, syntax highlighting and enhanced desktop activation load through optional
  adapters. The core requires Qt base, Qt PDF/PDF Widgets and libzip; optional
  backend SDKs no longer become mandatory application runtime dependencies.
• Known formats with a missing optional reader show file information and an
  Open Settings action. Plain text remains available without highlighting.
• Markdown opens at the beginning of the document, and the Contents control
  stays in the toolbar when available.
• Images reopen fitted after dismissal, instead of retaining a previous image
  session's maximized/fullscreen state. Maximization within a browsing session
  and saved document geometry retain their existing behavior.
• Custom color icons identify application windows, desktop launchers and the
  Dolphin/Thunar context actions. Small sizes use a simplified design; embedded
  icons also work before installation. The README displays the primary icon.
• Builds generate offline compatibility reports that distinguish dependency
  candidates from validated OS support. Arch VM tooling checks packages with
  optional runtime libraries absent, and CI adds a Debian 12 / Qt 6.4 baseline gate.

Downloads and upgrading

Choose the runtime installer for your distribution. Downloads are attached after
the release package, test, clean-install and native GNOME checks succeed.

System	Installer
Fedora 44, x86_64	dzurkel-0.7.1-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_0.7.1-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-0.7.1-1-x86_64.pkg.tar.zst

# Fedora
sudo dnf install ./dzurkel-0.7.1-1.fc44.x86_64.rpm

# Debian 13
sudo apt install ./dzurkel_0.7.1-1_amd64.deb

# Arch Linux: update first, then install
sudo pacman -Syu
sudo pacman -U ./dzurkel-0.7.1-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside the installer and verify with
sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned; checksums
verify integrity and are not signatures. No Dzurkel update repository is provided.

Preferences and integration backups are preserved. Existing Thunar actions retain
their old icon until Restore previous shortcuts… and Enable Space shortcut…
are used after the upgrade. Dolphin Space setup still requires 26.04 or newer.
Quit and remove a user-local development installation's managed executable and
launchers before installing a system package so they do not shadow it.

Validation and known limits

The release preparation build passed all 23 local CTest suites, including staged
installation and icon payload checks. Earlier checks for the changes since 0.7.0
include a Debian 12 / Qt 6.4.2 baseline build with 20 passing suites, missing-library
checks in a fresh Arch runtime container, and focused native KDE and GNOME Wayland
checks. These results do not certify every distribution or desktop combination.

An intermittent native GNOME table-geometry transition failure was observed; its
focused rerun and the image maximize/dismiss/reopen checks passed. Ubuntu currently
receives general missing-library guidance; Ubuntu-specific copyable installation
commands have not been reviewed. Compatibility reports do not automatically claim
support for older releases, derivatives or unreviewed architectures. Audio formats
and playback still depend on installed backends and codecs.

See testing evidence,
installation,
runtime compatibility
and preview limits.

Dzurkel v0.7.0

Dzurkel 0.7.0 adds audio, formatted-document and e-book previews. Select a file,
press Space, inspect its content and close the preview.

Changes

• Audio playback with play/pause, seeking, volume/mute and available track metadata.
  Supported formats depend on the installed Qt media backend and codecs.
• DOCX and RTF previews with readable text and basic formatting. Legacy DOC uses
  the optional, already-installed antiword extractor for text-only previews.
• DRM-free EPUB, FB2 and Chitanka SFB previews, plus common unencrypted MOBI 6
  files using PalmDOC compression or uncompressed text.
• Formatted Markdown with headings, lists, emphasis, code and simple tables.
• Clearer heading hierarchy, list indentation and paragraph spacing. Simple DOCX
  text colors are retained when they have readable contrast against the theme.
• Portrait defaults for document, e-book, Markdown and plain-text previews.
  Text zoom changes content size inside the window; PDF/table sizing, compact
  audio previews and natural image sizing retain their existing behavior.
• A shorter legacy-document footer: DOC · Text-only preview.

Scope and limits

These are bounded content previews. Exact page layout, editing, annotations,
bookmarks and reading-progress management are omitted. Unsupported formatting
retains readable text where possible. Large documents show a labelled partial
preview. DRM-protected/encrypted content shows an error when extraction is
unavailable; Dzurkel does not unlock it.

MOBI support stays deliberately small: no HUFF/CDIC compression, standalone KF8,
AZW/AZW3 or KFX. FB2/MOBI images use placeholders, and complex tables become text.
No office suite, Calibre or additional e-book decoder is required.

Downloads

Choose the runtime installer for your distribution. Package managers resolve
runtime dependencies. Downloads appear after the package/test pipeline passes.

System	Installer
Fedora 44, x86_64	dzurkel-0.7.0-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_0.7.0-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-0.7.0-1-x86_64.pkg.tar.zst

# Fedora
sudo dnf install ./dzurkel-0.7.0-1.fc44.x86_64.rpm

# Debian 13
sudo apt install ./dzurkel_0.7.0-1_amd64.deb

# Arch Linux: update first, then install
sudo pacman -Syu
sudo pacman -U ./dzurkel-0.7.0-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside your installer and verify with
sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned;
checksums verify integrity and are not signatures.

Open Dzurkel Settings to enable or restore the optional file-manager
integration. Upgrading does not reassign shortcuts. Dolphin Space setup requires
26.04 or newer. Nautilus and Thunar support retain their existing scope.

Quit and remove a user-local development installation's managed executable and
launchers before installing a system package, so it does not shadow that package.
Keep preferences and integration backups. See the
installation guide
and supported formats and limits.

Dzurkel v0.6.2

Preview images, PDFs, text and CSV/TSV/XLSX spreadsheets with Space in Dolphin,
Nautilus (Files) and now Thunar.

Downloads

Choose the installer for your distribution; the package manager resolves runtime
dependencies. These are normal application packages. Debug packages, development
helpers and build metadata are excluded from this release's downloads.

System	Installer
Fedora 44, x86_64	dzurkel-0.6.2-1.fc44.x86_64.rpm
Debian 13, amd64	dzurkel_0.6.2-1_amd64.deb
Current Arch Linux, x86_64	dzurkel-0.6.2-1-x86_64.pkg.tar.zst

# Fedora
sudo dnf install ./dzurkel-0.6.2-1.fc44.x86_64.rpm

# Debian 13
sudo apt install ./dzurkel_0.6.2-1_amd64.deb

# Arch Linux: update first, then install
sudo pacman -Syu
sudo pacman -U ./dzurkel-0.6.2-1-x86_64.pkg.tar.zst

Download SHA256SUMS alongside your installer and verify downloaded files with
sha256sum --check --ignore-missing SHA256SUMS. Packages are unsigned; checksums
verify integrity and are not signatures.

Changes

• Thunar: opt-in Space and right-click previews, desktop detection, reversible
  setup and preservation of existing actions and shortcuts.
• Thunar restart: focus returns once to Dzurkel Settings after Thunar reopens;
  closing or minimizing Settings cancels the pending request.
• GNOME: Nautilus Space preview service and centered adaptive Wayland previews,
  retaining the stable image/document resize and focus behavior.
• Regression protection for Thunar setup/restore and restart focus, plus required
  native GNOME placement, focus and Nautilus keyboard checks in package CI.

After installation, open Dzurkel Settings and enable the integration for your
file manager. Installation itself does not reassign shortcuts. Thunar setup
targets one selected local file on XFCE/X11. Dolphin Space setup requires 26.04
or newer. GNOME integration needs no Shell extension or global shortcut.

Before replacing a user-local development install, quit that copy and remove its
managed executable and launchers so they do not shadow the system package. Keep
preferences and integration backups. See the
installation guide
and Thunar setup.