Skip to main content

Pylphin

A fast, keyboard-friendly, Dolphin-inspired file explorer built with PyQt6 and the Breeze icon theme. Designed for Linux and Windows with a consistent dark theme, live drive rescan, quick-look previews, and a clean picker API.

Python Version License Platform


Features

  • Dolphin-style UI — Breeze Dark theme, breadcrumb navigation, icon/list/details views
  • Quick Look (GlimpseSpeedy) — Press Space to preview images, text, audio, and video without leaving the app
  • Live Drive Sidebar — Auto-rescanning device list with capacity bars and one-click eject
  • Cross-Platform — Native feel on Linux and Windows
  • Picker API — Use Pylphin as a file/folder picker dialog inside your own PyQt6 apps
  • Local-First Icons — Ships with 100+ Breeze SVGs; no internet required after install
  • MIME-Aware — Extension mapping + libmagic fallback for accurate file type icons

Installation

From PyPI

pip install pylphin

Linux Prerequisites

Pylphin uses python-magic for MIME detection on Linux, which requires the system libmagic library:

# Debian / Ubuntu
sudo apt-get install libmagic1

# Fedora / RHEL
sudo dnf install file-libs

# Arch
sudo pacman -S file

Optional Dependencies

For audio metadata display in previews:

pip install pylphin[audio]

Usage

Standalone File Manager

# Launch the GUI
pylphin

# Or via module
python -m pylphin

As a Picker Dialog

from pylphin import pick_file, pick_files, pick_folder

# Single file
path = pick_file(extension=".py")
print(path)

# Multiple files
paths = pick_files(extension=[".jpg", ".png"])
print(paths)

# Folder
folder = pick_folder(start_path="/home/user/Documents")
print(folder)

Embedding in Your Own App

from PyQt6.QtWidgets import QApplication
from pylphin import Pylphin

app = QApplication([])
win = Pylphin()
win.show()
app.exec()

Keyboard Shortcuts

Key Action
Alt + ← Back
Alt + → Forward
Alt + ↑ Up one directory
F5 Reload
F2 Rename selected
Delete Delete selected
Space Quick Look preview
Esc Close preview / cancel address edit
← / → Previous / next file in preview
Backspace Navigate back
Ctrl + H Toggle hidden files

Project Structure

pylphin/
├── src/pylphin/
│   ├── __init__.py          # Public API
│   ├── __main__.py          # python -m pylphin
│   ├── pylphin.py           # Main application
│   └── assets/
│       └── icons/           # 100+ Breeze SVG icons
├── pyproject.toml
├── README.md
└── LICENSE

Platform Notes

Platform Details
Linux ✅ Full support. Drive eject via udisksctl/eject. Requires libmagic1.
Windows ✅ Full support. Drive eject via DeviceIoControl + PowerShell fallback. Bundled python-magic-bin.
macOS ❌ Not supported. Uses Windows/Linux-specific APIs.

License

This project is licensed under the GNU General Public License v2.0.

See LICENSE for the full text.

The bundled Breeze icons are from the KDE Breeze Icons project and are licensed under LGPL-3.0.


Author

D. Saahishnu Ram


Contributing

Issues and pull requests are welcome on GitHub.

Metadata

Release files for pylphin 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pylphin 0.1.0
File Size Uploaded Provenance Actions
pylphin-0.1.0.tar.gz 136.7 kB Without provenance Details for pylphin-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pylphin 0.1.0
File Interpreter ABI Platform Actions
pylphin-0.1.0-py3-none-any.whl Python 3 none any Details for pylphin-0.1.0-py3-none-any.whl

Total release size: 472.8 kB

Release files / pylphin-0.1.0.tar.gz

Download URL pylphin-0.1.0.tar.gz
Size 136.7 kB
Tags Source
SHA-256 checksum
How to use checksums
da851a212a8c3ed4f455b8e174efd6a580f390426830f061ff8a2cd17233aacc
BLAKE2b-256 checksum
How to use checksums
86bc9859bee4e97b8a39d4fd6953dd94985ba2ba683a01cd51756064e30a4aeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Release files / pylphin-0.1.0-py3-none-any.whl

Download URL pylphin-0.1.0-py3-none-any.whl
Size 336.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3a62e3f0be42852c01abf614e517f3a12445f440dfaaf72d225e54e1f71f7075
BLAKE2b-256 checksum
How to use checksums
d8e258fd3208ce01118cb956dc1b394d3b1a1432a646613677ce6f38217b7dce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.3

Security for pylphin 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page