https://github.com/longkidkoolstar/foldermap
FolderPeek is a cross-platform GUI application designed for visualizing directory structures.
https://github.com/longkidkoolstar/foldermap
cross-platform dark-theme directory-structure export-feature file-explorer file-management folder-viewer gui hidden-files open-source python text-view tkinter tree-view
Last synced: about 1 year ago
JSON representation
FolderPeek is a cross-platform GUI application designed for visualizing directory structures.
- Host: GitHub
- URL: https://github.com/longkidkoolstar/foldermap
- Owner: longkidkoolstar
- License: mit
- Created: 2025-03-23T21:05:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-23T21:08:36.000Z (about 1 year ago)
- Last Synced: 2025-03-23T22:21:04.240Z (about 1 year ago)
- Topics: cross-platform, dark-theme, directory-structure, export-feature, file-explorer, file-management, folder-viewer, gui, hidden-files, open-source, python, text-view, tkinter, tree-view
- Language: TeX
- Homepage: https://github.com/longkidkoolstar/FolderMap
- Size: 11.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📁 FolderPeek - Enhanced Folder Structure Viewer
```markdown
A cross-platform GUI application for visualizing directory structures with advanced viewing modes and hidden file management.
```
## ✨ Features
- **Multiple View Modes**
- 🎯 Target Only: Show contents of selected folder
- ⬆️ With Preceding: Display path hierarchy from root
- ⬇️ With Succeeding: Show subsequent folders in parent directory
- 👁️ Hidden File Management
- Toggle visibility of hidden files/folders (.*)
- Automatic mode adjustment when hiding files
- 💾 Export Capability
- Save structure as TXT file with icons
- 🌗 Dual Panel Interface
- Tree View (left) and Text View (right)
- Modern dark theme with improved contrast
## 📥 Installation
1. **Prerequisites**
- Python 3.6+
- Tkinter (usually included with Python)
2. **Setup**
```bash
git clone https://github.com/yourusername/folderpeek.git
cd folderpeek
```
## 🚀 Usage
```bash
python folderpeek.py
```
### Interface Guide
1. **Select Folder**
- Click "📂 Select Folder" to choose directory
- Supported on Windows/macOS/Linux
2. **View Modes**
- Use dropdown to switch between modes
- *With Preceding* disabled when hiding files
3. **Hidden Files**
- Check "Hide Hidden Files" to exclude .* items
- Auto-refreshes current view
4. **Export**
- Click "💾 Export TXT" to save structure
- Choose destination path in dialog
## ⚠️ Important Notes
- Permission restrictions may limit some directory access
- Symbol meanings:
- 📁 = Folder
- 📄 = File
- ⛔ = Permission denied
- ❌ = Missing path component
- Folder names are case-sensitive on Linux/macOS
## 🤝 Contributing
Contributions welcome! Please:
1. Open an issue to discuss changes
2. Fork repository and create feature branch
3. Submit pull request with detailed description
## 📜 License
MIT License - See [LICENSE](LICENSE) file for details
---
**FolderPeek** © 2025 - Developed with ❤️ using Python & Tkinter
Project maintained under active development