{"id":44666054,"url":"https://github.com/xonixx/serv","last_synced_at":"2026-02-15T00:33:34.591Z","repository":{"id":46019032,"uuid":"186025736","full_name":"xonixx/serv","owner":"xonixx","description":"Share easily file / folder over local network","archived":false,"fork":false,"pushed_at":"2024-09-15T23:16:39.000Z","size":262,"stargazers_count":11,"open_issues_count":8,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-09-15T23:59:58.452Z","etag":null,"topics":["graal-native","graalvm","java"],"latest_commit_sha":null,"homepage":null,"language":"Java","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/xonixx.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":"2019-05-10T17:11:28.000Z","updated_at":"2024-09-15T22:04:30.000Z","dependencies_parsed_at":"2024-09-13T10:19:07.492Z","dependency_job_id":null,"html_url":"https://github.com/xonixx/serv","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/xonixx/serv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xonixx%2Fserv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xonixx%2Fserv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xonixx%2Fserv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xonixx%2Fserv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xonixx","download_url":"https://codeload.github.com/xonixx/serv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xonixx%2Fserv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29461911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T22:42:09.113Z","status":"ssl_error","status_checked_at":"2026-02-14T22:42:05.053Z","response_time":53,"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":["graal-native","graalvm","java"],"created_at":"2026-02-15T00:33:30.365Z","updated_at":"2026-02-15T00:33:34.577Z","avatar_url":"https://github.com/xonixx.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct-single.svg)](https://stand-with-ukraine.pp.ua)\n\n# serv\n\n[![Unit Tests](https://github.com/xonixx/serv/actions/workflows/run-tests.yml/badge.svg)](https://github.com/xonixx/serv/actions/workflows/run-tests.yml)\n\nThe simple tool to quickly share file or folder in local network.\n\nAfter running the tool it gives you the precise commands that you can pass to your teammate to receive the file(s).\n\nThe tool also renders simple static server web-UI:\n\n![web-UI](img.png)\n\n## Usage\n\nSharing a file:\n```bash\n$ serv '/path/to/report.pdf' \nTo download the file please use one of the commands below: \n\ncurl http://192.168.0.179:17777/dl \u003e 'report.pdf'\nwget -O- http://192.168.0.179:17777/dl \u003e 'report.pdf'\ncurl http://192.168.0.179:17777/dl?z --compressed \u003e 'report.pdf'\nwget -O- http://192.168.0.179:17777/dl?z | gunzip \u003e 'report.pdf'\n```\n\nSharing a folder (all the files in it):\n```bash\n$ serv '/path/to/folder' \nTo download the files please use one of the commands below. \nNB! All files will be placed into current folder!\n\ncurl http://192.168.0.179:17777/dl | tar -xvf -\nwget -O- http://192.168.0.179:17777/dl | tar -xvf -\ncurl http://192.168.0.179:17777/dl?z | tar -xzvf -\nwget -O- http://192.168.0.179:17777/dl?z | tar -xzvf -\n\nFiles listing: http://192.168.0.179:17777/\n```\n\nHelp message:\n```\n$ serv -h\nserv ver. 1.0.1 (GraalVM CE 21.3.0, openjdk 17.0.1 2021-10-19)\nusage: serv [...options] \u003cfile or folder\u003e [...\u003cfile or folder\u003e]\n -H,--host \u003carg\u003e    host to serve on (default is determined automatically)\n -h,--help          print help and exit\n    --include-vcs   include VCS files (default = false)\n -p,--port \u003carg\u003e    port to serve on (default = 17777)\n -v,--version       print version and exit\n```\n\n*Yes! All that simple!*\n\n## Install\n\nSorry, but only Linux x64 is supported at the moment. Hopefully this will improve.\n\nTo install or update the tool simply run the command below.\n\n```shell\nsudo bash -e -c \"\nwget https://github.com/xonixx/serv/releases/download/v1.0.1/serv-linux-amd64 -O/usr/local/bin/serv\nchmod +x /usr/local/bin/serv\necho \\\"serv \\$(serv -v) installed successfully\\\" \n\"\n```\n\nAlso since the tool is written in Java (and compiled to executable via [GraalVM](https://github.com/oracle/graal) AOT compiler) \nit can also be run in any environment with Java 8 or above as traditional Java app.\n\n## Dev notes\n\nCaptured a tag with last commit where favicon was done via embedding bytes in Java code: [favicon-via-bytes-in-java](https://github.com/xonixx/serv/tree/favicon-via-bytes-in-java). This was necessary since this was the most reliable way to serve resources in Graal at time.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxonixx%2Fserv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxonixx%2Fserv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxonixx%2Fserv/lists"}