{"id":18360589,"url":"https://github.com/samasaur1/simpleswiftserver","last_synced_at":"2025-04-06T13:32:41.494Z","repository":{"id":34978905,"uuid":"154903919","full_name":"Samasaur1/SimpleSwiftServer","owner":"Samasaur1","description":"A Swift executable equivalent to Python's SimpleHTTPServer — plus more!","archived":false,"fork":false,"pushed_at":"2025-01-05T01:04:23.000Z","size":56,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-17T17:02:42.465Z","etag":null,"topics":["clt","command-line-tool","hacktoberfest","server","swift"],"latest_commit_sha":null,"homepage":"https://samasaur1.github.io/projects/simpleswiftserver.html","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Samasaur1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-10-26T23:14:27.000Z","updated_at":"2025-01-05T01:04:27.000Z","dependencies_parsed_at":"2024-05-11T09:45:32.345Z","dependency_job_id":null,"html_url":"https://github.com/Samasaur1/SimpleSwiftServer","commit_stats":{"total_commits":20,"total_committers":3,"mean_commits":6.666666666666667,"dds":"0.15000000000000002","last_synced_commit":"ecb070647abbfc57e4ccb1425b81e9c82c291412"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samasaur1%2FSimpleSwiftServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samasaur1%2FSimpleSwiftServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samasaur1%2FSimpleSwiftServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Samasaur1%2FSimpleSwiftServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Samasaur1","download_url":"https://codeload.github.com/Samasaur1/SimpleSwiftServer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247488805,"owners_count":20947001,"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":["clt","command-line-tool","hacktoberfest","server","swift"],"created_at":"2024-11-05T22:29:03.146Z","updated_at":"2025-04-06T13:32:41.228Z","avatar_url":"https://github.com/Samasaur1.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Server\n\nA Swift executable equivalent to Python's SimpleHTTPServer — with extra features!\n\n## Installing\nMake sure Xcode 10.2 or higher is installed first (not necessary with Nix).\n\n### [Nix](https://nixos.org)\n\nThis repository is a flake, so:\n\n```sh\nnix profile install github:Samasaur1/SimpleSwiftServer\n```\n\nor add this to `environment.systemPackages`/`home.packages`, assuming your flake inputs are available as `inputs`:\n\n```nix\ninputs.SimpleSwiftServer.packages.${pkgs.system}.default\n```\n\n### [Mint](https://github.com/yonaskolb/mint)\n\n#### Install\n```sh\n$ mint install Samasaur1/SimpleSwiftServer\n```\n\n##### Update\n```sh\n$ mint install Samasaur1/SimpleSwiftServer\n```\n\n### Swift Package Manager\n\n**Use CLI**\n\n```sh\n$ git clone https://github.com/Samasaur1/SimpleSwiftServer.git\n$ cd SimpleSwiftServer\n$ swift run server\n```\n\n### [Homebrew](https://brew.sh) \\[Not Recommended\\]\n\n```sh\n$ brew install Samasaur1/core/simpleswiftserver\n```\n\nI don't use Homebrew anymore, and it's kind of a pain to maintain a formula, so I probably won't update this package past v4.3.1. I *might* update it with critical bug fixes, but I make no promises.\n\n## Usage\n\nSimpleSwiftServer has two modes: a file downloader (to easily share files) and a directory browser. It also allows you to specify your port.\n\nThe default port is 1234, the default mode is a directory browser, and the default path is the current directory.\n\n***\nOpens a directory browser from the current directory on port 1234\n```sh\n$ server\n```\n\nOpens a directory browser from the current directory on port 4321\n```sh\n$ server 4321\n```\n\nOpens a directory browser from the `Desktop` subdirectory on port 1234\n```sh\n$ server --browse Desktop\n```\n\nOpens a file downloader for the file `Package.swift` in the Desktop subdirectory on port 1234\n```sh\n$ server --file Desktop/Package.swift\n```\n\nOpens a directory browser from the root directory on port 46264. **Note: this is a terrible idea, as any confidential files (tokens, keys) are publically accessible.** Share the smallest amount of your system that you need.\n```sh\n$ server 46264 --browse /\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamasaur1%2Fsimpleswiftserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamasaur1%2Fsimpleswiftserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamasaur1%2Fsimpleswiftserver/lists"}