# Shirube-Filer — Full Content for AI Agents

> Source: https://shirube-filer.pages.dev | Updated: 2026-07-14

---

## Product Overview

Shirube-Filer (しるべファイラー) is a fast, customizable, cross-platform desktop file manager built with Tauri v2 (Rust backend + React/TypeScript frontend). It runs on Windows, macOS, and Linux.

**Tagline:** 自分の手に馴染む、究極にカスタマイズできる高速ファイラー。
("A high-speed file manager that adapts to your hand — ultimately customizable.")

**Design principles:**
- Native performance via Rust backend
- Zero telemetry — no data sent to the developer
- Fully local operation — works offline
- Deep customizability through a pane/tab layout system
- Credentials stored in OS secure store, never on developer servers

---

## Features

### Layout & Navigation
- Unlimited split panes arranged horizontally or vertically
- Multi-tab interface per pane with tab pinning and drag-and-drop
- Dual-pane and multi-pane workflows
- Breadcrumb navigation with path editing
- Bookmark and favorites system
- Directory tree sidebar
- OSC 7 CWD tracking (terminal ↔ file pane sync)

### File Operations
- Copy, move, delete, rename (with undo support)
- Batch rename with regex and template substitution
- Archive creation and extraction: zip, tar.gz, tar.zst, and more
- Symlink creation
- File comparison (diff viewer)
- Checksum calculation (MD5, SHA-256)
- Duplicate file finder
- Color labels and tag system for file organization
- File organization rules (auto-sort by rule)

### Search & Index
- Full-text search across directory trees
- File index for instant results on large filesystems
- Grep across file contents with highlighted matches
- Filter by extension, size, date, tag, color label

### Preview
- Text files with syntax highlighting
- Images (JPEG, PNG, WEBP, HEIC, etc.) with EXIF metadata display
- Video and audio playback
- PDF preview
- Archive contents browser
- Hex view for binary files
- Git diff viewer

### Terminal (Direct Edition Only)
- Built-in PTY terminal pane (disabled in App Store / Microsoft Store editions)
- Multiple terminal tabs per pane
- Shell selection (bash, zsh, PowerShell, etc.)
- OSC 7 directory sync with file browser pane

### Cloud Integrations
Supported as addon panels within the app:
- **Amazon S3** — list buckets, browse objects, upload, download, delete
- **Box** — OAuth 2.0 (authorization code; Box does not support PKCE). The browser returns to the app via a static relay page on this site (/oauth/box) because Box requires an HTTPS redirect URI; the relay page does not store or transmit authorization codes. Browse folders, upload, download, delete
- **Dropbox** — OAuth 2.0 (PKCE), browse folders, upload, download, delete
- **Google Drive** — OAuth 2.0 (PKCE), browse, upload, download, delete
- **Google Cloud Storage** — OAuth 2.0 (PKCE), browse buckets/objects, upload, download, delete
- **Microsoft OneDrive** — OAuth 2.0 (PKCE), browse, upload, download, delete
- **SFTP** — password auth, browse remote, upload, download
- **WebDAV** — browse, upload, download, delete, mkdir

### Git Integration
- Repository status display in file list
- Stage / unstage changes
- Commit with message
- Branch checkout
- Git log with diff viewer
- Git show
- Stash save, apply, pop, drop, list
- Git blame

### Extensibility
- Addon system: HTML/JS addons loaded from the filesystem via file:// protocol
- Custom context menu commands (user-defined shell commands; Direct edition only)
- Customizable keybindings
- Theme support (dark/light and custom CSS variables)
- Layout import/export

### Privacy & Security
- Zero telemetry, zero analytics, zero tracking
- No developer-operated server
- Credentials stored in OS secure store: Windows Credential Manager, macOS Keychain, Linux Secret Service
- One-click full data deletion (Settings → Import/Export → Delete all data)
- Open source (PolyForm Noncommercial 1.0.0)

---

## Editions Comparison

| Feature | Direct (Windows/macOS/Linux) | Mac App Store | Microsoft Store |
|---------|:---:|:---:|:---:|
| All file operations | ✅ | ✅ | ✅ |
| Search & index | ✅ | ✅ | ✅ |
| Preview (text/image/video/PDF) | ✅ | ✅ | ✅ |
| Cloud integrations | ✅ | ✅ | ✅ |
| Git integration | ✅ | ✅ | ✅ |
| Addon system | ✅ | ✅ | ✅ |
| Terminal pane (PTY) | ✅ | ❌ | ❌ |
| Shell command execution | ✅ | ❌ | ❌ |
| Custom context-menu commands | ✅ | ❌ | ❌ |

PTY and shell execution are disabled in store editions to comply with App Sandbox (macOS) and Microsoft Store policy 10.2.6.

---

## Pricing & License

- **Pricing:** Buy-once (exact price TBD at launch). No subscription.
- **Store binaries (App Store / Microsoft Store):** commercial/business use permitted under the applicable store terms.
- **Source code:** [PolyForm Noncommercial 1.0.0](https://github.com/ynaoak/shirube-filer/blob/main/LICENSE) — noncommercial use only. Commercial use of the source requires a separate license.
- **GitHub Sponsors:** optional development support at https://github.com/sponsors/ynaoak

---

## Technical Details

- **Stack:** Tauri v2, React 18, TypeScript, Rust (2021 edition)
- **Frontend build:** Vite + pnpm workspace
- **Backend crates:** tokio, rayon, git2, russh/russh-sftp, aws-sdk-s3, notify, jwalk, keyring
- **Platforms:** Windows 10+, macOS 12+, Linux (AppImage / .deb)
- **Build targets:**
  - `make build-windows` — Windows Direct (MSI + NSIS)
  - `make build-msstore` — Windows Microsoft Store (MSI, shell/PTY disabled)
  - `make build-direct-mac` — macOS Direct (DMG)
  - `make build-mas` — macOS Mac App Store (sandbox + Security-Scoped Bookmarks)
  - `make build-linux` — Linux (AppImage / .deb, via Docker)
- **Versioning:** `pnpm bump-version <x.y.z>` updates package.json, tauri.conf.json, Cargo.toml in sync

---

## Privacy Policy (Full Text — English)

*Last updated: 2026-06-21*
*Source: https://shirube-filer.pages.dev/privacy*

Shirube-Filer is a local-first file manager designed with your privacy as a priority.

### 1. We do not collect your data

The App contains no telemetry, analytics, or tracking of any kind. The developer does not collect, store, or transmit your files, file names, activity, usage statistics, or any other personal information. No account is required.

### 2. Data stored on your device

All app settings and state are stored only on your device and are never sent to the developer:

- **App configuration directory** (Windows: %APPDATA% / macOS & Linux: home directory) — settings, keybindings, layouts, bookmarks, context menus, organization rules, file tags (tags.yaml), cloud sync job connection settings (cloud-sync.yaml, which contains no secrets).
- **App local storage** (browser storage within the app) — theme, language, UI preferences, cloud integration profiles.

You can remove everything via Settings → Import/Export → Delete all data (includes OS credential store entries).

### 3. Storage of credentials and tokens

- **Cloud sync (S3 / SFTP / WebDAV):** secret keys and passwords are stored in the OS secure credential store (Windows Credential Manager / macOS Keychain / Linux Secret Service). No secrets are written to config files.
- **OAuth integrations (Box / Dropbox / Google Drive / GCS / OneDrive):** refresh tokens stored in OS secure credential store. Access tokens held in memory only.

### 4. Network communication

The App only communicates with third-party services you explicitly configure, and with the OS/store for app updates. No developer-operated server is involved.

### 5. Third-party services

Amazon S3 (AWS), Box, Dropbox, Google Drive / GCS, Microsoft OneDrive, SFTP/WebDAV servers you specify. OAuth providers use PKCE; authorization happens directly on each provider's page.

### 6. Files and terminal

File operations run locally. The terminal launches a local shell and does not transmit input externally. Terminal is disabled in some editions due to OS sandbox constraints.

### 7–10. Other

No data collected from children. Credentials in OS secure store. Policy changes posted here. Contact: https://github.com/ynaoak/shirube-filer/issues

---

## Terms of Use (Full Text — English)

*Last updated: 2026-06-21*
*Source: https://shirube-filer.pages.dev/terms*

### 1. License to use

- **Official store binaries (App Store / Microsoft Store):** commercial/business use permitted under applicable store terms and these Terms.
- **Source code and source-derived builds:** PolyForm Noncommercial 1.0.0 — noncommercial use only. Commercial use requires a separate license.

See https://github.com/ynaoak/shirube-filer/blob/main/LICENSING.md

### 2. Prohibited conduct

- Unlawful use or violation of public order
- Commercial use or redistribution of source beyond PolyForm Noncommercial
- Distributing a paid build competing with the official version
- Infringing third-party rights

### 3. Third-party services

Your use of integrated third-party services is governed by their own terms and is at your own responsibility. The developer is not liable for their availability or data handling.

### 4. Data and backups

The App performs file operations (create, move, delete, compress). Back up important data beforehand. The developer is not liable for data loss.

### 5. No warranty

The App is provided "AS IS" without warranties of any kind.

### 6. Limitation of liability

To the maximum extent permitted by law, the developer is not liable for any damages arising from use or inability to use the App.

### 7–9. Other

Terms may be revised; revisions posted here. Governed by Japanese law; disputes subject to courts having jurisdiction over the developer's location. Contact: https://github.com/ynaoak/shirube-filer/issues

---

## Links

- Website: https://shirube-filer.pages.dev
- GitHub: https://github.com/ynaoak/shirube-filer
- Issues / Support: https://github.com/ynaoak/shirube-filer/issues
- GitHub Sponsors: https://github.com/sponsors/ynaoak
- License: https://github.com/ynaoak/shirube-filer/blob/main/LICENSE
- Licensing Policy: https://github.com/ynaoak/shirube-filer/blob/main/LICENSING.md
- Privacy Policy: https://shirube-filer.pages.dev/privacy
- Terms of Use: https://shirube-filer.pages.dev/terms
- llms.txt: https://shirube-filer.pages.dev/llms.txt