Skip to content
DyskLabPublic

About

An Eagle-style desktop asset manager — Electron + Svelte + TypeScript + sharp. Tidy, human-readable local libraries with tags, folders, smart folders, filters, and rich previews.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

DyskFiles

DyskFiles

A desktop asset manager that keeps your library in tidy, readable folders: thumbnails and JSON, no database.

Latest release MIT License Part of DyskLab Buy Me a Coffee

DyskFiles grid view

Create a library, drag in your images, videos, audio, and text files, then browse and organize them. Unlike Eagle, which stores items in randomly named xxxx.info/ folders, DyskFiles keeps everything in flat folders you can read in Finder or Explorer, grouped by the first three letters of each file name.

Download

Get it from the latest release:

  • macOS (Apple Silicon): DyskFiles-<version>-arm64.dmg. Open it and drag DyskFiles into Applications.
  • Windows (64-bit): DyskFiles-<version>-x64-setup.exe. Run it and follow the installer.

The Mac app isn't notarized, so macOS blocks the first launch. Open System Settings > Privacy & Security and choose Open Anyway, or run:

xattr -dr com.apple.quarantine /Applications/DyskFiles.app

The Windows installer isn't code-signed, so SmartScreen may warn on the first run: choose More info > Run anyway.

On Intel Macs, run it from source.

Updates: DyskFiles checks GitHub for a new release once a day (or from DyskFiles > Check for Updates…). When one is out, it downloads and opens the installer: on macOS, quit the app and drag the new version onto Applications; on Windows, quit the app and finish the setup. Turn the daily check off in the Check for Updates dialog.

Features

Libraries

  • Keep several <name>.dyskfiles libraries and switch between them from the sidebar. The last one reopens on launch.
  • Change a library's icon, reveal it in Finder, merge it into another library, remove it, or delete it.
  • Check Library finds missing thumbnails, unreadable or stray files, leftovers from interrupted saves, and links to deleted folders or unlisted tags, and repairs them. Nothing is deleted: stray files go to lost-found/, and items whose original is gone are listed for you to deal with.
  • Libraries made before the rename (<name>.pitek) open as they are.

Importing

  • Drag and drop, a file picker, a whole folder, or a URL.
  • Linked imports reference files where they are, so the library holds only metadata and a thumbnail.
  • Eagle libraries: import a .library folder with its tags, folders, ratings, notes, and URLs. The Eagle library is only read, and running it again skips what was already imported.
  • Auto Import: watch folders and copy in every new file that lands there, including files added while the app was closed.

Media

  • Images: WebP thumbnails up to 400px, made with sharp.
  • Video and audio: built-in players, with a poster frame captured automatically for video.
  • Text and code: a CodeMirror editor with syntax highlighting.
  • PDF: a thumbnail of the first page and a scrolling viewer with zoom, rendered with pdf.js.
  • Fonts (TTF, OTF, WOFF, WOFF2): a sample thumbnail and a preview with your own text at several sizes.
  • Open in default app: edit a file in the app that owns it; when you save, DyskFiles notices and redraws it.

Organizing

  • Multiple folders per item, tags with an All Tags page, and smart folders that save a filter.
  • Views for All, Uncategorized, Untagged, Recently Used, Random, and Trash.
  • Filters for type, color, shape, rating, dimensions, duration, size, dates, comment, note, and URL.
  • Search with a configurable scope and a small query language: tag:logo ext:png,jpg rating:>3 size:<2mb -draft (hover the search box for the full list).
  • Duplicate detection for identical files (by content hash) and for similar-looking images (by perceptual hash).

Viewing and editing

  • Waterfall, justified, grid, and list layouts, with zoom and sorting.
  • An inspector with rating, tags, folders, notes, URL, color palette, and metadata.
  • A preview with rotate, flip, fit or actual size, crop, and next and previous.
  • Undo (⌘Z) for renames, ratings, tags, folders, notes, URLs, and moving to or restoring from the trash.
  • Export the items in the current view (a folder, filter, or search) to a new folder, with metadata.json and a metadata.csv you can open in a spreadsheet.
Inspector Preview Add menu
Inspector and color palette Preview with its toolbar Add menu with import options

Library layout on disk

Each item's metadata, original, and thumbnail sit together in a folder named after the first three letters of the file name:

MyLibrary.dyskfiles/
├── library.json             # name, version, createdAt, itemCount
├── tags.json                # tag list
├── filters.json             # smart folders
├── folders.json             # folders
├── watch.json               # watched folders for Auto Import
├── lost-found/              # files moved aside by Check Library (only if needed)
├── pre/                     # files whose names start with "pre"
│   ├── preview-l9x2ka.json  # one metadata file per item
│   ├── preview-l9x2ka.png   # the original (left out for linked imports)
│   └── preview-l9x2ka.webp  # the thumbnail
└── mov/
    ├── movie-k1p8.json
    ├── movie-k1p8.mov
    └── movie-k1p8.webp

Libraries in the older items/, originals/, and thumbnails/ layout are migrated the first time they're opened.

Run from source

You need Node.js.

git clone https://github.com/DyskLab/dyskfiles.git
cd dyskfiles
npm install
npm run dev
Command What it does
npm run build Bundles the app into out/
npm run check Runs svelte-check
npm test Runs the library tests with Vitest
npm run dist Builds the Apple Silicon DMG into dist/
npm run dist:win Builds the 64-bit Windows installer into dist/ (works from a Mac too)

Releasing

  1. Bump version in package.json and run npm run dist and npm run dist:win. Building for Windows from a Mac needs sharp's Windows binary first: npm install --no-save --force @img/sharp-win32-x64@<sharp version>.
  2. Create a GitHub release tagged v<version> (not a draft or pre-release) and attach dist/DyskFiles-<version>-arm64.dmg and dist/DyskFiles-<version>-x64-setup.exe.

The app compares the tag with its own version and picks the installer for its platform (.dmg on macOS, .exe on Windows) whose name contains its architecture (arm64 or x64), so keep that naming.

Project structure

  • src/main/ owns all file access: libraries and storage (library.ts), thumbnails (thumbnail.ts), saved settings (config.ts), file watching for edited items and Auto Import (watcher.ts), update checks (updater.ts), and the window, IPC handlers, and asset:// protocol (index.ts).
  • src/preload/ exposes a small typed window.rak API through contextBridge (types in api.d.ts).
  • src/renderer/ is the Svelte 5 and TypeScript interface.

Support

DyskFiles is free and open source. If it helps you, you can buy me a coffee.

Part of DyskLab

DyskFiles is part of DyskLab, alongside DyskFlow, DyskFocus, and DyskLink for Mac and Android.

License

MIT

About

An Eagle-style desktop asset manager — Electron + Svelte + TypeScript + sharp. Tidy, human-readable local libraries with tags, folders, smart folders, filters, and rich previews.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages