https://github.com/ysskrishna/directory-printer
A GUI application for viewing and exporting directory structures. This tool provides a simple and intuitive way to visualize the structure of directories and their contents.
https://github.com/ysskrishna/directory-printer
cross-platform desktop-app directory-listing directory-tree file-explorer github-actions internationalization linux macos open-source poetry python python-gui release-automation self-hosted tkinter windows
Last synced: 9 months ago
JSON representation
A GUI application for viewing and exporting directory structures. This tool provides a simple and intuitive way to visualize the structure of directories and their contents.
- Host: GitHub
- URL: https://github.com/ysskrishna/directory-printer
- Owner: ysskrishna
- License: agpl-3.0
- Created: 2025-01-28T15:41:41.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-15T07:23:51.000Z (10 months ago)
- Last Synced: 2025-03-15T08:22:57.763Z (10 months ago)
- Topics: cross-platform, desktop-app, directory-listing, directory-tree, file-explorer, github-actions, internationalization, linux, macos, open-source, poetry, python, python-gui, release-automation, self-hosted, tkinter, windows
- Language: Python
- Homepage: https://www.producthunt.com/posts/directory-printer
- Size: 2.75 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Directory Printer
A GUI application for viewing and exporting directory structures. This tool provides a simple and intuitive way to visualize the structure of directories and their contents.
## Video Demo 👇
[](https://youtu.be/RWOIlvB1PJU)
[Watch the full demo on YouTube](https://youtu.be/RWOIlvB1PJU)
## Features
- Interactive GUI for directory selection
- Copy directory tree to clipboard
- Export directory structure to text files
- Smart file filtering using standard ignore patterns (.gitignore, .dockerignore) to exclude unwanted files and directories
- Tree-like visualization of directory structures
- Handles permission errors gracefully
- Cross-platform compatibility (Windows, Linux, macOS)
- Multi-language support (English, Spanish, Chinese)
- Progress tracking with status indicators
- Recent files history
- Configurable settings with persistent storage
- Built-in update checker
## Installation
### Download Binary (Recommended)
Download the latest release for your operating system from the [Releases page](https://github.com/ysskrishna/directory-printer/releases).
- Windows: Download and extract `directory-printer-windows-.zip`
- Linux: Download and extract `directory-printer-linux-.zip`
- macOS: Download and extract `directory-printer-macos-.zip`
## Documentation
- **[CHANGELOG.md](CHANGELOG.md)**: Contains a chronologically ordered list of notable changes for each version of the project.
- **[DEVELOPMENT.md](DEVELOPMENT.md)**: Comprehensive guide for developers, including installation from source, development practices, dependency management with Poetry, and pre-commit hook setup.
- **[RELEASES.md](RELEASES.md)**: Documents our release pipeline process, including branch management, version tagging, and release creation procedures.
## FAQ
### Why do I see a warning about an unidentified developer on macOS?
On macOS, you may see a warning that the application is from an unidentified developer. This is because the application is not signed with an Apple Developer Certificate. To bypass this warning:
1. Right-click on the application
2. Select "Open"
3. Click "Open" in the confirmation dialog
The application will now run without the warning.
### How can I change the application language?
You can change the application language through the `File` menu:
1. Click on `File` in the menu bar
2. Look for the language selection option
3. Choose your preferred language (English, Spanish, or Chinese)
The application will remember your language preference for future sessions.
### How do I check for updates?
You can check for new versions of Directory Printer through the `Help` menu:
1. Click on `Help` in the menu bar
2. Select `Check for Updates`
3. The application will notify you if a new version is available
### Why do I see a warning about an unknown publisher on Windows?
On Windows, you may see a warning that the application is from an unknown publisher. This is because the application is not signed with a code signing certificate. To bypass this warning:
1. Click "More info"
2. Click "Run anyway"
The application will now run without the warning.
### Why do I see a warning about an untrusted application on Linux?
On Linux, you may see a warning that the application is untrusted. This is because the application is not signed with a code signing certificate. To bypass this warning:
1. Right-click on the application
2. Select "Properties"
3. Navigate to the "Permissions" tab
4. Check the box next to "Allow executing file as program"
The application will now run without the warning.
## License
Copyright (c) 2025 [Y. Siva Sai Krishna](https://github.com/ysskrishna)
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).