{"id":27301269,"url":"https://github.com/jcoupalk/flyserve","last_synced_at":"2025-04-12T01:45:24.547Z","repository":{"id":221967905,"uuid":"755898135","full_name":"JCoupalK/FlyServe","owner":"JCoupalK","description":"FlyServe is a simple web server written in Go, designed to serve files and directories over HTTP quickly and without hassle for file sharing.","archived":false,"fork":false,"pushed_at":"2025-03-31T15:13:13.000Z","size":27,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T16:38:57.736Z","etag":null,"topics":["file-listing","file-sharing","golang","http","http-server","web-server"],"latest_commit_sha":null,"homepage":"https://jcoupal.com","language":"Go","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/JCoupalK.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}},"created_at":"2024-02-11T12:23:44.000Z","updated_at":"2025-03-31T15:13:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"a74cdf8b-df60-461b-90a1-78e3a92d24ec","html_url":"https://github.com/JCoupalK/FlyServe","commit_stats":null,"previous_names":["jcoupalk/flyserve"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCoupalK%2FFlyServe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCoupalK%2FFlyServe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCoupalK%2FFlyServe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JCoupalK%2FFlyServe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JCoupalK","download_url":"https://codeload.github.com/JCoupalK/FlyServe/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505939,"owners_count":21115354,"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":["file-listing","file-sharing","golang","http","http-server","web-server"],"created_at":"2025-04-12T01:45:24.046Z","updated_at":"2025-04-12T01:45:24.541Z","avatar_url":"https://github.com/JCoupalK.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n \u003cimg src=\"https://github.com/JCoupalK/FlyServe/assets/108779415/e2cc0123-bfcc-4191-8a83-6ccf37d8e687\"\n\u003c/p\u003e\n\n# FlyServe\n![License](https://img.shields.io/github/license/JCoupalK/FlyServe)\n![GitHub issues](https://img.shields.io/github/issues-raw/JCoupalK/FlyServe)\n![GitHub go.mod Go version (branch \u0026 subdirectory of monorepo)](https://img.shields.io/github/go-mod/go-version/JCoupalK/FlyServe/main)\n\nFlyServe is a simple web server written in Go, designed to serve files and directories over HTTP quickly and without hassle for file sharing. It provides features such as serving specific files (including a website if HTML), serving directories, basic authentication, and directory listings.\n\n## Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Building from Source](#building-from-source)\n- [Usage](#usage)\n- [Examples](#examples)\n- [Screenshots](#screenshots)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- Serve specific files\n- Serve directories with directory listings\n- Basic authentication support\n- Customizable port number\n- Single binary, no external dependencies\n\n## Installation\n\n1. Download the binary with wget:\n\n    ```shell\n    wget https://github.com/JCoupalK/FlyServe/releases/download/1.0/flyserve_linux_amd64_1.0.tar.gz\n    ```\n\n2. Unpack it with tar\n\n    ```shell\n    tar -xf flyserve_linux_amd64_1.0.tar.gz\n    ```\n\n3. Move it to your /usr/local/bin/ (Optional):\n\n    ```shell\n    sudo mv flyserve /usr/local/bin/flyserve\n    ```\n\n## Building from Source\n\n1. Ensure you have Go installed on your system. You can download Go from [here](https://golang.org/dl/).\n2. Clone the repository:\n\n    ```shell\n    git clone https://github.com/JCoupalK/FlyServe\n    ```\n\n3. Navigate to the cloned directory:\n\n    ```shell\n    cd FlyServe\n    ```\n\n4. Build the tool:\n\n    ```shell\n    go build -o flyserve .\n    ```\n\n## Usage\n\nOptions:\n\n```txt\n-p, --port            Port to serve on (Default is 8080)\n-f, --file            Specific file to serve\n-d, --directory       Directory to serve files from (Default is current directory)\n-u, --username        Username for basic authentication\n-pw, --password       Password for basic authentication\n-h, --html            Enable auto-resolution of .html files\n```\n\n## Examples\n\n```bash\n# Serve files from the current directory on port 8080\nflyserve\n\n# Serve files from a specific directory on port 9000\nflyserve -d /path/to/directory -p 9000\n\n# Serve a specific file on port 8080 with basic authentication\nflyserve -f /path/to/file.txt -u username -pw password\n\n# Serve websites by just specifying a directory that contains an index.html\nflyserve -d /path/to/website -p 80 -h\n```\n\n## Screenshots\n\n\u003cimg alt=\"screenshot1\" width=\"400\" src=\"https://github.com/JCoupalK/FlyServe/assets/108779415/74c10791-62d5-4e68-988a-62dfba2965ff\"/\u003e\n\u003cbr\u003e\n\u003cimg alt=\"screenshot2\" width=\"400\" src=\"https://github.com/JCoupalK/FlyServe/assets/108779415/3e93a041-c54e-4c64-96fb-d59ff63e6640\"/\u003e\n\u003cbr\u003e\n\u003cimg alt=\"screenshot3\" width=\"400\" src=\"https://github.com/JCoupalK/FlyServe/assets/108779415/da666e86-ae02-4c25-8fe7-cb5f9f8f04c0\"/\u003e\n\n## Contributing\n\nContributions are welcome. If you find a bug or have a feature request, please open an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcoupalk%2Fflyserve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjcoupalk%2Fflyserve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjcoupalk%2Fflyserve/lists"}