- C++ 98.9%
- CMake 0.5%
- PowerShell 0.5%
- Shell 0.1%
| docs | ||
| packaging | ||
| resources | ||
| src | ||
| test_photos | ||
| tests | ||
| third_party | ||
| .gitignore | ||
| build.ps1 | ||
| build.sh | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| CMakeLists.txt | ||
| README.md | ||
| release.ps1 | ||
Filer
Bleskově rychlý průzkumník souborů pro Linux a Windows (C++17, GLFW, Dear ImGui, OpenGL, SQLite). Vznikl přestavbou fotogalerie Photor: přebírá její pipeline náhledů a celou filozofii – UI vlákno nikdy nečeká na disk ani na síť.
Podrobný popis všech funkcí se snímky obrazovky je ve wiki.
Co umí
- Velikost a poslední změna každé složky – na pozadí se proskenují všechny lokální disky
(
getdents64+statx, ≈ 900 000 položek/s na NVMe), stav se ukládá do lokální SQLite databáze a po dalším startu je k dispozici během desetin sekundy. - Živá aktualizace – změny na disku (inotify na Linuxu,
ReadDirectoryChangesWna Windows) se do zobrazené složky i do velikostí nadřazených složek promítnou zhruba do 100 ms. - Okamžitý vstup do podsložek – při otevření složky se na pozadí vypíšou všechny její podsložky.
- Dvě zobrazení (přepínač vpravo dole):
- Mřížka jako Google Disk – složky nahoře, pod nimi soubory; fotky a videa s náhledy (vložené EXIF miniatury, disková cache, priorita viditelných).
- Tabulka – Název, Změněno před, Změněno, Velikost; řazení klikem na záhlaví.
- Strom vlevo – Rychlý přístup, Disky (každý disk jako kořen, štítky, HDD/SSD), Síť a média.
- Taby nad obsahem složky – každý má vlastní složku, historii, výběr, filtr, scroll a zobrazení; přetahují se myší, soubory puštěné na tab jdou do jeho složky, při startu se obnoví. Hledání v celém indexu se otevírá ve vlastním tabu „Výsledek hledání“ (Esc ho zavře).
- Drag & drop – soubory z jiných aplikací do Fileru (kopie, Shift = přesun), mezi složkami ve Fileru (stejný disk = přesun, jiný = kopie, Ctrl/Shift mění) a z Fileru ven (nativně na Waylandu, na Windows přes Shell).
- Archivy jako složky –
.zip,.7z,.rar,.tar,.iso, … se procházejí jako složka (C:\x\foto.zip\2024\img.jpg); kopírování ven i dovnitř, mazání, přejmenování, „Rozbalit do“, „Přidat do archivu“, archivy s heslem. Pracuje přes příkazovou řádku 7-Zip (7zz/7zna Linuxu; na Windows přibalený7z.exevedlefiler.exe, jinak nainstalovaný 7-Zip). - Hledání v celém indexu (Ctrl+F) – všechny disky za desítky milisekund, podle jména i cesty (
*,?,projekty*src), volitelně jen v podsložkách zobrazené složky. - Operace se soubory ve frontě (pořadí tažením, pozastavení), souběžně na různých discích, ověření kopie čtením z disku, obnova po pádu, opakování jako správce při chybějících právech.
- Samostatná okna – tab se dá vytáhnout do vlastního okna; okna se po restartu znovu otevřou.
- Síť a média – připojení sdílení s přihlášením, obsazenost, odpojení / vysunutí; mrtvý server nezasekne aplikaci.
- Git – puntíky u změněných a nových souborů a u rozpracovaných repozitářů.
- Odkazy a knihovny –
.lnk, symbolické a pevné odkazy (zobrazení i vytváření), přeložené názvy knihoven.
Ovládání
| Klávesa | Akce |
|---|---|
| Enter / dvojklik | otevřít složku nebo soubor (výchozí aplikace) |
| Shift + dvojklik | ukázat soubor v systémovém správci souborů |
| Backspace, Alt+↑, ← (tabulka) | o úroveň výš |
| → (tabulka) | otevřít vybranou složku |
| Tab | přepnout klávesnici mezi obsahem a stromem složek |
| ↑/↓, ←/→ ve stromu | jiná složka (hned se otevře), sbalit / rozbalit, nadřazená / první podsložka |
| Enter, Esc ve stromu | zpět do obsahu |
| Alt+← / Alt+→, tlačítka myši 4/5 | zpět / vpřed |
| Ctrl+L | adresní řádek (cesta, ~, file://, smb://) |
| F5, Ctrl+R | obnovit |
| Ctrl+1 / Ctrl+2 | mřížka / tabulka |
| Ctrl+kolečko, Ctrl+= / Ctrl+- | velikost dlaždic |
| Ctrl+H | skryté soubory |
| Ctrl+A, Esc | vybrat vše / zrušit výběr |
| psaní | filtr položek podle názvu (Esc zruší) |
| Ctrl+F, Ctrl+K | hledat v celém indexu |
| Ctrl+C / Ctrl+X / Ctrl+V | kopírovat / vyjmout / vložit (text ve schránce vytvoří textový soubor) |
| Delete / Shift+Delete | do koše / smazat trvale |
| F2, Ctrl+Shift+N, Alt+Enter | přejmenovat, nová složka, vlastnosti |
| Ctrl+T / Ctrl+W | nový tab (stejná složka) / zavřít tab |
| Ctrl+Shift+T | znovu otevřít zavřený tab |
| Ctrl+Tab, Ctrl+PageDown / Ctrl+Shift+Tab, Ctrl+PageUp | další / předchozí tab |
| Alt+1 … Alt+8, Alt+9 | tab podle pořadí, poslední tab |
| kolečko myši nad adresou nebo taby | další (dolů) / předchozí (nahoru) tab |
| prostřední tlačítko na složce / na tabu | otevřít v novém tabu (na pozadí) / zavřít tab |
Stažení
- Windows: hotové balíčky jsou na stránce Vydání (Releases) repozitáře –
Filer-X.Y.Z-windows-arm64.zipaFiler-X.Y.Z-windows-x64.zippodle procesoru. Stačí rozbalit a spustitFiler\filer.exe(7-Zip je přibalený). - Linux: balíčky se nevydávají, Filer si každý sestaví ze zdrojových kódů (níže).
Verze programu: filer --version; co je v které verzi nového, popisuje CHANGELOG.md.
Sestavení
Linux
# Fedora
sudo dnf install -y gcc-c++ cmake mesa-libGL-devel libX11-devel libXrandr-devel libXinerama-devel \
libXcursor-devel libXi-devel fontconfig-devel glib2-devel wayland-devel libxkbcommon-devel
./build.sh # build/bin/filer, build/bin/test_filer, build/bin/filer_bench
./build.sh --install # + instalace do ~/.local (binárka, zástupce, ikona)
Balíček RPM pro Fedoru (z pracovního stromu, verze z CMakeLists.txt; závislosti pro sestavení
sudo dnf builddep packaging/filer.spec):
./packaging/build-rpm.sh # dist/filer-<verze>-1.fc<N>.<arch>.rpm
sudo dnf install ./dist/filer-*.rpm
Balíček nezakládá D-Bus službu org.freedesktop.FileManager1 (systémovou má Nautilus); aby „Zobrazit ve
složce“ z jiných aplikací otevíral Filer, je potřeba ./build.sh --install (služba v ~/.local).
Windows (PowerShell)
.\build.ps1 # build\bin\filer.exe (+ 7z.exe, 7z.dll, 7-Zip-License.txt)
Build přibalí 7z.exe a 7z.dll z C:\Program Files\7-Zip (jinou složku určí
-DFILER_7ZIP_DIR=...) vedle filer.exe spolu s licencí 7-Zip jako 7-Zip-License.txt. Bez
nainstalovaného 7-Zip build jen varuje a archivy pak vyžadují 7-Zip na cílovém počítači.
Spuštění: filer [složka] (bez argumentu domovská složka).
Vydání pro Windows (jen správce repozitáře): doplnit sekci do CHANGELOG.md a spustit
.\release.ps1 -Version X.Y.Z – sestaví a otestuje ARM64 i x64, zabalí oba zipy, vytvoří značku vX.Y.Z a vydání
na Forgeji. .\release.ps1 -DryRun jen sestaví a zabalí do dist\.
Testy a měření
./build/bin/test_filer
./build/bin/filer_bench scan ~ # rychlost skenu
./build/bin/filer_bench list /usr/bin # rychlost výpisu jedné složky
Data aplikace
- Index a nastavení:
~/.local/share/filer/index.db(Windows%LOCALAPPDATA%\Filer\index.db). Je to jen cache – smazáním se vše znovu proskenuje. - Náhledy:
~/.cache/filer/thumbs(Windows%LOCALAPPDATA%\Filer\thumbs).
Třetí strany
GLFW 3.4, Dear ImGui 1.92, stb (image, image_resize2, image_write), SQLite 3.53.4 – vše přiložené
v third_party/. Na Windows se k programu přibaluje 7-Zip (7z.exe, 7z.dll; © Igor Pavlov,
GNU LGPL s omezením unRAR, viz 7-Zip-License.txt, zdrojové kódy na https://www.7-zip.org).
Dokumentace pro vývoj: CLAUDE.md, docs/ANALYSIS.md, docs/ARCHITECTURE.md, docs/PLAN.md.
