Metadata-Version: 2.5
Name: ferrum-fm
Version: 0.1.2
Summary: A fast, stable, DE-agnostic TUI file manager
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: jeepney>=0.8.0
Requires-Dist: keyring>=24.0.0
Requires-Dist: keyrings-alt>=4.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: send2trash>=1.8.0
Requires-Dist: smbprotocol>=1.12.0
Requires-Dist: textual>=0.47.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Ferrum

A fast, stable, DE-agnostic TUI file manager built with Python and Textual.

## Features

- Browse local and SMB filesystems
- Tabs with independent navigation
- Collapsible sidebar with places, bookmarks, and saved network shares
- Toggleable preview pane with syntax highlighting
- Copy, cut, paste with conflict resolution
- Trash and permanent delete with confirmation
- Rename and new directory
- Multi-file selection with space and shift+click
- SMB credentials stored in system keyring
- Persistent SMB connections across sessions

## Installation

### From pip
pip install ferrum-fm

### On NixOS
See ferrum.nix

## Usage
fe

## Hyprland / Bare Wayland Compositor Users

The `.desktop` file uses `Terminal=true` which works with most desktop environments (GNOME, KDE, XFCE). If you're using Hyprland or another bare Wayland compositor that doesn't have a default terminal association, you may need to edit the desktop entry to explicitly specify your terminal emulator:
```
Exec=kitty fe
```

Replace `kitty` with your preferred terminal (`foot`, `alacritty`, `wezterm`, etc.).
