{"id":29354316,"url":"https://github.com/blacktechx011/btxs","last_synced_at":"2025-07-09T03:13:13.269Z","repository":{"id":302631075,"uuid":"1013085378","full_name":"BlackTechX011/BTXS","owner":"BlackTechX011","description":"a simple file splitter","archived":false,"fork":false,"pushed_at":"2025-07-03T12:03:12.000Z","size":60,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-03T12:25:22.753Z","etag":null,"topics":["blacktechx","blacktechx011","btxs","file-splitter","go","go-language","muti-platform","opensource","splitter"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlackTechX011.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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}},"created_at":"2025-07-03T10:34:36.000Z","updated_at":"2025-07-03T12:03:15.000Z","dependencies_parsed_at":"2025-07-03T12:25:37.932Z","dependency_job_id":"15af62d2-8ffa-45d7-a8e0-382d691585a5","html_url":"https://github.com/BlackTechX011/BTXS","commit_stats":null,"previous_names":["blacktechx011/btxs"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/BlackTechX011/BTXS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FBTXS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FBTXS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FBTXS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FBTXS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackTechX011","download_url":"https://codeload.github.com/BlackTechX011/BTXS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackTechX011%2FBTXS/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264384421,"owners_count":23599616,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["blacktechx","blacktechx011","btxs","file-splitter","go","go-language","muti-platform","opensource","splitter"],"created_at":"2025-07-09T03:13:03.893Z","updated_at":"2025-07-09T03:13:13.263Z","avatar_url":"https://github.com/BlackTechX011.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\u003cp align=\"center\"\u003e\n  \u003cpre\u003e\n██████╗ ████████╗██╗  ██╗███████╗\n██╔══██╗╚══██╔══╝╚██╗██╔╝██╔════╝\n██████╔╝   ██║    ╚███╔╝ ███████╗\n██╔══██╗   ██║    ██╔██╗ ╚════██║\n██████╔╝   ██║   ██╔╝ ██╗███████║\n╚═════╝    ╚═╝   ╚═╝  ╚═╝╚══════╝\n                                 \n  \u003c/pre\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eBTXS™ File Splitter\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A modern, reliable, high-performance command-line file splitter and merger.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/BlackTechX011/BTXS/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/BlackTechX011/BTXS?style=for-the-badge\u0026logo=github\u0026color=blue\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/BlackTechX011/BTXS/blob/main/LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/github/license/BlackTechX011/BTXS?style=for-the-badge\u0026color=lightgrey\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/BlackTechX011/BTXS/actions/workflows/release.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/BlackTechX011/BTXS/release.yml?style=for-the-badge\u0026logo=githubactions\u0026logoColor=white\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#-quick-start\"\u003eQuick Start\u003c/a\u003e •\n  \u003ca href=\"#-command-reference\"\u003eCommands\u003c/a\u003e •\n  \u003ca href=\"#-contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#-license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n**BTXS™** is a professional command-line tool for splitting large files into smaller, more manageable chunks and merging them back together. It's built from the ground up to be reliable and provide a polished user experience, ensuring your data is never corrupted during the process.\n\n\u003e [!NOTE]\n\u003e BTXS™ embeds a unique header in every chunk. This allows the `merge` command to automatically find and assemble the correct pieces, even if chunks from multiple different files are in the same directory.\n\n## 🚀 Installation\n\nThe recommended way to install BTXS™ is with our one-line installer. It automatically detects your OS and architecture, downloads the correct binary from the latest release, and adds it to your system's PATH.\n\n\u003e [!IMPORTANT]\n\u003e The scripts below are the *only* official installation methods. Always download from the official **BlackTechX011/BTXS** repository to ensure you are getting a secure and untampered version of the tool.\n\n---\n\n### Linux / macOS / Termux\n\nThis command works on most Unix-like systems, including Debian/Ubuntu, Fedora, Arch, macOS (Intel \u0026 Apple Silicon), and Termux on Android.\n\n```sh\ncurl -fsSL https://raw.githubusercontent.com/BlackTechX011/BTXS/main/scripts/install.sh | sh\n```\n\n\u003e [!TIP]\n\u003e After installation, you may need to restart your terminal or run `source ~/.zshrc`, `source ~/.bashrc`, etc., to refresh your `PATH` environment variable.\n\n---\n\n### Windows (PowerShell)\n\n\u003e [!NOTE]\n\u003e This command temporarily adjusts the execution policy **only for the current process**. It's a safe and standard way to run trusted remote scripts and does not permanently change your system's security settings.\n\n**Open a new PowerShell (as a regular user) and run:**\n\n```powershell\nSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass; iwr https://raw.githubusercontent.com/BlackTechX011/BTXS/main/scripts/install.ps1 | iex\n```\n\u003e [!WARNING]\n\u003e You **must** open a new PowerShell window after the installation completes. The `PATH` environment variable is only loaded when a new terminal session starts.\n\n\u003cdetails\u003e\n  \u003csummary\u003eManual Installation\u003c/summary\u003e\n  \n  1. Go to the [**Releases page**](https://github.com/BlackTechX011/BTXS/releases/latest).\n  2. Download the appropriate binary for your operating system and architecture (e.g., `btxs-windows-amd64.exe`).\n  3. Rename the binary to `btxs` (or `btxs.exe` on Windows).\n  4. Move the binary to a directory included in your system's `PATH` (e.g., `/usr/local/bin` on Linux/macOS, or a custom folder on Windows that you add to the Path Environment Variable).\n  5. On Linux/macOS, make the binary executable: `chmod +x /usr/local/bin/btxs`.\n\u003c/details\u003e\n\n## ⚡ Quick Start\n\nUsing BTXS™ is designed to be intuitive. Here are the most common operations.\n\n### 1. Split a File\n\nTo split a large file into smaller `.btxs` chunks:\n\n```sh\n# Split a large backup file into 50MB chunks\nbtxs split --in database_backup.sql --out ./backup_parts --size 50MB\n```\n\nThis will create files like `database_backup.0001.btxs`, `database_backup.0002.btxs`, etc.\n\n\u003e [!TIP]\n\u003e Use the `-n` or `--name` flag to give your chunks a custom name:\n\u003e `btxs split ... --name \"project-alpha-backup\"`\n\n### 2. Merge Chunks\n\nTo reassemble the original file from a directory of chunks:\n\n```sh\n# BTXS will automatically find all related .btxs files and merge them\nbtxs merge --dir ./backup_parts\n```\n\nThe merged file will be saved in the parent directory as `merged_database_backup.sql`.\n\n## 📖 Command Reference\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand the full command reference\u003c/summary\u003e\n\n| Command | Alias | Description | Options |\n| :--- | :--- | :--- | :--- |\n| `split` | `s` | Splits a file into smaller, encrypted chunks. | `--in \u003cpath\u003e` (Required)\u003cbr\u003e`--out \u003cdir\u003e`\u003cbr\u003e`--size \u003csize\u003e`\u003cbr\u003e`--name \u003cname\u003e` |\n| `merge`| `m` | Merges `.btxs` chunks back into the original file. | `--dir \u003cdir\u003e` |\n| `help`   | `h` | Displays help information for a command. | |\n\n\u003c/details\u003e\n\n---\n\n## 🗺️ Project Roadmap\n\nThis project is actively developed. Here is a list of planned features. Contributions are welcome!\n\n### Core Features\n- [x] Core `split` and `merge` commands\n- [x] Data integrity verification via SHA-256\n- [x] Smart chunk detection and assembly\n- [x] Custom chunk naming\n- [ ] Add support for different encryption ciphers (`--cipher`)\n- [ ] Implement a `test` command to verify chunk integrity without merging\n- [ ] Implement a `repair` command for partially damaged sets (if possible)\n\n### User Experience\n- [x] Professional CLI with help and versioning\n- [x] Cross-platform build and release workflow\n- [ ] Implement self-update mechanism (`btxs update`)\n- [ ] Add detailed progress bars for large file operations\n- [ ] Add a global configuration file (`~/.config/btxs/config.toml`)\n\n### Documentation \u0026 Community\n- [x] `LICENSE.md` with custom EULA\n- [x] `CONTRIBUTING.md` and Issue Templates\n- [ ] Create a GitHub Pages site for full documentation\n\n\u003e **Have an idea or found a bug?** [**Open an issue!**](https://github.com/BlackTechX011/BTXS/issues/new/choose) We'd love to hear from you.\n\n## 🤝 Contributing\n\nContributions are the backbone of open source. We welcome contributions of all kinds, from filing detailed bug reports to implementing new features.\n\nBefore you start, please take a moment to read our guidelines:\n\n-   **[Contribution Guide](CONTRIBUTING.md):** The main guide for how to submit pull requests, our coding standards, and the development process.\n-   **[Open an Issue](https://github.com/BlackTechX011/BTXS/issues/new/choose):** The best place to report a bug, ask a question, or propose a new feature.\n\n## 🛡️ Security Model\n\n\u003e [!CAUTION]\n\u003e This software is provided \"as is\" without warranty of any kind. While the lightweight encryption provides obfuscation, it is not a substitute for enterprise-grade cryptographic standards. For highly sensitive data, encrypt the file *before* splitting it.\n\nThe security of BTXS™ is a top priority. If you discover a security vulnerability, we ask that you report it to us privately to protect our users.\n\n**Please do not open a public GitHub issue for security-related concerns.**\n\nInstead, send a detailed report directly to: **`BlackTechX@proton.me`**\n\nWe will make every effort to respond to your report in a timely manner.\n\n## ⚖️ License\n\nThis software is distributed under a custom End-User License Agreement (EULA).\n\n\u003e [!IMPORTANT]\n\u003e The license grants permission for **personal, non-commercial use only**. For any other use, including commercial, corporate, or government, please contact the author.\n\nPlease see the [**LICENSE.md**](LICENSE.md) file for the full terms and conditions.\n\n---\n*BTXS™ is a trademark of [BlackTechX011](https://github.com/BlackTechX011). All rights reserved.*\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacktechx011%2Fbtxs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblacktechx011%2Fbtxs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblacktechx011%2Fbtxs/lists"}