{"id":29734112,"url":"https://github.com/eja/taz","last_synced_at":"2026-01-16T03:02:53.682Z","repository":{"id":301736764,"uuid":"1010152871","full_name":"eja/taz","owner":"eja","description":"Temporary Autonomous Zone","archived":false,"fork":false,"pushed_at":"2025-12-29T22:53:27.000Z","size":66969,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-07T06:42:27.992Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eja.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-28T13:12:36.000Z","updated_at":"2025-12-29T22:52:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"f3b53af7-0395-46b8-9f7c-1350f200da64","html_url":"https://github.com/eja/taz","commit_stats":null,"previous_names":["eja/taz"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/eja/taz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eja%2Ftaz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eja%2Ftaz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eja%2Ftaz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eja%2Ftaz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eja","download_url":"https://codeload.github.com/eja/taz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eja%2Ftaz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28476689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:02:43.018Z","status":"ssl_error","status_checked_at":"2026-01-16T03:01:27.857Z","response_time":107,"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":[],"created_at":"2025-07-25T10:39:17.406Z","updated_at":"2026-01-16T03:02:53.659Z","avatar_url":"https://github.com/eja.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TAZ\n **Temporary Autonomous Zone** - A lightweight, cross-platform web-based file manager for instant file sharing and management.\n\n## Overview\nTAZ is a simple, self-contained web application that allows you to quickly set up a file management interface on any supported device. Perfect for temporary file sharing, collaborative work environments, or when you need instant access to files across different devices on a network.\n\n## Features\n- 🌐 **Web-based interface** - Access from any browser\n- 📁 **Full file management** - Upload, download, create folders, rename, delete\n- 💬 **BBS messaging system** - Optional bulletin board for team communication\n- 🔒 **Optional password protection** - Secure write operations\n- 🔗 **External links** - Add custom links to your file manager homepage\n- 📱 **Responsive design** - Works on desktop and mobile\n- ⚡ **Zero dependencies** - Single binary deployment\n- 🖥️ **Cross-platform** - Available for multiple operating systems\n- 📝 **Logging support** - Optional request logging to file or stderr\n\n## Quick Start\n\n### Download and Run\n1. Download the appropriate binary for your platform from the [Releases](../../releases) page\n2. Make it executable (Unix-like systems):\n   ```bash\n   chmod +x taz\n   ```\n3. Run with default settings:\n   ```bash\n   ./taz\n   ```\n4. Open your browser to `http://localhost:35248`\n\n### Basic Usage Examples\n\n#### Simple file server\n```bash\n./taz -root /path/to/your/files\n```\n\n#### Password-protected with custom port\n```bash\n./taz -password mypassword -web-port 8080\n```\n\n#### With BBS messaging system\n```bash\n./taz -bbs messages.db\n```\n\n#### Full-featured setup with command-line flags\n```bash\n./taz \\\n  -password secret \\\n  -bbs team-messages.db \\\n  -url \"Documentation|https://example.com/docs\" \\\n  -url \"Team Chat|https://chat.example.com\" \\\n  -log \\\n  -log-file access.log\n```\n\n#### Using a configuration file\nCreate a `config.json` file with your settings:\n```json\n{\n  \"password\": \"secret\",\n  \"bbs\": \"team-messages.db\",\n  \"url\": [\n    \"Documentation|https://example.com/docs\",\n    \"Team Chat|https://chat.example.com\"\n  ],\n  \"log\": true,\n  \"log_file\": \"access.log\"\n}\n```\nThen run TAZ, pointing it to your config file:\n```bash\n./taz -config config.json\n```\n\n#### Listen on all interfaces\n```bash\n./taz -web-host 0.0.0.0 -web-port 8080\n```\n\n## Command Line Options\n\n| Option | Default | Description |\n|--------|---------|-------------|\n| `-web-host` | `localhost` | Host address to listen on |\n| `-web-port` | `35248` | Port for the web server |\n| `-password` | (empty) | Password for write operations |\n| `-root` | `files` | Root directory for file management |\n| `-bbs` | (empty) | Path to SQLite database for BBS messaging (disabled if not provided) |\n| `-log` | `false` | Enable request logging |\n| `-log-file` | (empty) | Path to log file (uses stderr if empty) |\n| `-url` | (none) | External links (format: `Name\\|URL`), can be used multiple times |\n| `-config` | (empty) | Path to a JSON configuration file. See details below. |\n\n### Using a Configuration File (`-config`)\nFor complex setups, you can manage all command-line options using a JSON configuration file. This is useful for creating reusable and easily shareable configurations.\n\nTo use a configuration file, pass its path to the `-config` flag:\n```bash\n./taz -config my_settings.json\n```\n\nIn the JSON file, the option names are the same as the command-line flags, but with hyphens (`-`) replaced by underscores (`_`).\n\n**Example `config.json`:**\n```json\n{\n  \"web_host\": \"0.0.0.0\",\n  \"web_port\": 8080,\n  \"password\": \"secret\",\n  \"root\": \"/shared/team-files\",\n  \"bbs\": \"team-board.db\",\n  \"log\": true,\n  \"log_file\": \"taz_access.log\",\n  \"url\": [\n    \"Documentation|https://example.com/docs\",\n    \"Team Chat|https://chat.example.com\"\n  ]\n}\n```\n\n**Note:** Any options passed directly on the command line will override the values specified in the configuration file. For example:\n```bash\n# The web port will be 9090, overriding the value in the config file.\n./taz -config config.json -web-port 9090\n```\n\n### BBS Messaging System\nThe BBS (Bulletin Board System) feature provides a simple messaging interface for team communication:\n\n- **Enable BBS**: Use the `-bbs` flag with a database file path (e.g., `-bbs messages.db`)\n- **Database**: Uses SQLite to store messages persistently\n- **Default behavior**: BBS is disabled when no database path is provided\n- **Access**: Available through the web interface alongside file management\n\nExample BBS usage:\n```bash\n# Enable BBS with custom database\n./taz -bbs team-board.db \n\n# BBS disabled (default behavior)\n./taz -root /shared/files\n```\n\n### External Links\nYou can add custom links to the homepage using the `-url` flag multiple times:\n```bash\n./taz \\\n  -url \"Company Intranet|http://intranet.company.com\" \\\n  -url \"Project Repository|https://github.com/user/project\" \\\n  -url \"https://eja.tv\"  # URL without custom name\n```\n\n## Building from Source\n```bash\ngit clone https://github.com/eja/taz.git\ncd taz\nmake\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feja%2Ftaz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feja%2Ftaz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feja%2Ftaz/lists"}