{"id":28432249,"url":"https://github.com/x-cod3r/text-maker","last_synced_at":"2026-04-29T01:02:17.862Z","repository":{"id":297436235,"uuid":"996770452","full_name":"x-cod3r/Text-Maker","owner":"x-cod3r","description":"A simple tool to convert different languages programing files like .py .cpp .h nto .text files","archived":false,"fork":false,"pushed_at":"2025-06-06T13:08:46.000Z","size":8908,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-01T08:42:03.153Z","etag":null,"topics":["consolidate","conversion","cpp","file","file2text","fileto","filetotext","python","text"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/x-cod3r.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-05T12:44:12.000Z","updated_at":"2025-06-06T13:08:48.000Z","dependencies_parsed_at":"2025-06-05T13:33:33.835Z","dependency_job_id":null,"html_url":"https://github.com/x-cod3r/Text-Maker","commit_stats":null,"previous_names":["x-cod3r/text-maker"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/x-cod3r/Text-Maker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FText-Maker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FText-Maker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FText-Maker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FText-Maker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/x-cod3r","download_url":"https://codeload.github.com/x-cod3r/Text-Maker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x-cod3r%2FText-Maker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32405904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T19:38:08.556Z","status":"ssl_error","status_checked_at":"2026-04-28T19:37:55.688Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["consolidate","conversion","cpp","file","file2text","fileto","filetotext","python","text"],"created_at":"2025-06-05T16:36:07.984Z","updated_at":"2026-04-29T01:02:17.855Z","avatar_url":"https://github.com/x-cod3r.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📄 File to Text Converter\n\n\u003cdiv align=\"center\"\u003e\n\n![Python](https://img.shields.io/badge/Python-3.6+-blue.svg)\n![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)\n![License](https://img.shields.io/badge/License-MIT-green.svg)\n![GUI](https://img.shields.io/badge/GUI-Tkinter-orange.svg)\n\n*A simple, elegant GUI tool to convert multiple code files into a single text document*\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Supported Formats](#-supported-file-formats) • [Screenshots](#-screenshots)\n\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n- 🎯 **Simple \u0026 Intuitive**: Clean, user-friendly interface\n- 📁 **Flexible Selection**: Browse individual files or entire folders\n- 🔧 **Customizable Output**: Control headers, separators, and structure\n- 🌐 **Smart Encoding**: Automatically handles different text encodings\n- 📊 **Progress Tracking**: Real-time processing status\n- 🛡️ **Error Handling**: Gracefully manages unreadable files\n- 🚀 **Cross-Platform**: Works on Windows, macOS, and Linux\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Python 3.6 or higher\n- tkinter (usually included with Python)\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/file-to-text-converter.git\n   cd file-to-text-converter\n   ```\n\n2. **Run directly** (no additional dependencies needed!)\n   ```bash\n   python file_to_text_converter.py\n   ```\n\n### Alternative: Download Release\nDownload the latest release from the [Releases page](https://github.com/x-cod3r/Text-Maker/releases) and run the standalone executable.\n\n## 🎮 Usage\n\n### Basic Workflow\n1. **Launch** the application\n2. **Select Files**: \n   - Click \"Browse Files\" for individual selection\n   - Click \"Browse Folder\" to scan entire directories\n3. **Configure Options**:\n   - ✅ Include filename headers\n   - ✅ Add separators between files\n   - ✅ Preserve folder structure\n4. **Convert**: Click \"Convert to Text File\" and choose output location\n\n### Command Line Alternative\nFor automation, you can also use the tool programmatically:\n\n```python\nfrom file_to_text_converter import FileToTextConverter\nimport tkinter as tk\n\n# Create and run the GUI\nroot = tk.Tk()\napp = FileToTextConverter(root)\nroot.mainloop()\n```\n\n## 📋 Supported File Formats\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n**Programming Languages**\n- C/C++ (`.cpp`, `.c`, `.cc`, `.cxx`)\n- Headers (`.h`, `.hpp`, `.hh`, `.hxx`)\n- Python (`.py`, `.pyw`)\n- JavaScript (`.js`, `.jsx`)\n- TypeScript (`.ts`, `.tsx`)\n- Java (`.java`)\n- C# (`.cs`)\n- PHP (`.php`)\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n**Additional Formats**\n- Ruby (`.rb`)\n- Go (`.go`)\n- Rust (`.rs`)\n- Swift (`.swift`)\n- Kotlin (`.kt`)\n- Scala (`.scala`)\n- Shell Scripts (`.sh`, `.bash`)\n- SQL (`.sql`)\n- And many more...\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 📸 Screenshots\n\n### Main Interface\n```\n┌─────────────────────────────────────────────┐\n│           File to Text Converter            │\n├─────────────────────────────────────────────┤\n│ Select Files: [Browse Files] [Browse Folder] [Clear] │\n│                                             │\n│ ┌─────────────────────────────────────────┐ │\n│ │ Selected Files:                         │ │\n│ │ • project/main.cpp                      │ │\n│ │ • project/utils.h                       │ │\n│ │ • project/data.py                       │ │\n│ │ • project/config.json                   │ │\n│ └─────────────────────────────────────────┘ │\n│                                             │\n│ Options:                                    │\n│ ☑ Include filename headers                  │\n│ ☑ Add separators between files             │\n│ ☐ Preserve folder structure in output      │\n│                                             │\n│           [Convert to Text File]            │\n│                                             │\n│ Status: 4 files selected                   │\n└─────────────────────────────────────────────┘\n```\n\n## 🛠️ Configuration Options\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| **Include filename headers** | Adds `=== filename.ext ===` before each file | ✅ Enabled |\n| **Add separators** | Inserts `========================================` between files | ✅ Enabled |\n| **Preserve folder structure** | Shows full path instead of just filename | ❌ Disabled |\n\n## 📝 Output Example\n\n```text\n=== main.cpp ===\n#include \u003ciostream\u003e\n#include \"utils.h\"\n\nint main() {\n    std::cout \u003c\u003c \"Hello World!\" \u003c\u003c std::endl;\n    return 0;\n}\n\n==================================================\n\n=== utils.h ===\n#ifndef UTILS_H\n#define UTILS_H\n\nvoid printMessage();\n\n#endif\n\n==================================================\n\n=== data.py ===\nimport json\n\ndef load_config():\n    with open('config.json', 'r') as f:\n        return json.load(f)\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how you can help:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Ideas for Contributions\n- 🎨 UI/UX improvements\n- 📝 Additional file format support\n- 🔧 Command-line interface\n- 🌍 Internationalization\n- 📦 Package management integration\n\n## 🐛 Bug Reports \u0026 Feature Requests\n\nFound a bug or have a feature idea? Please open an issue on the [Issues page](https://github.com/x-cod3r/Text-Maker/issues).\n\n**Bug Report Template:**\n- Python version\n- Operating system\n- Steps to reproduce\n- Expected vs actual behavior\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with Python's tkinter for maximum compatibility\n- Inspired by the need for simple code consolidation tools\n- Thanks to all contributors and users!\n\n## 📊 Stats\n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub stars](https://img.shields.io/github/stars/x-cod3r/Text-Maker?style=social)\n![GitHub forks](https://img.shields.io/github/forks/x-cod3r/Text-Maker?style=social)\n![GitHub issues](https://img.shields.io/github/issues/x-cod3r/Text-Maker)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/x-cod3r/Text-Maker)\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003cstrong\u003eMade with ❤️ for developers who need to consolidate their code\u003c/strong\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cod3r%2Ftext-maker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx-cod3r%2Ftext-maker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-cod3r%2Ftext-maker/lists"}