{"id":22170556,"url":"https://github.com/diegohce/hddproxy","last_synced_at":"2025-03-24T17:40:34.466Z","repository":{"id":139432224,"uuid":"179211239","full_name":"diegohce/hddproxy","owner":"diegohce","description":"A small proxy for web apps to access local files","archived":false,"fork":false,"pushed_at":"2020-02-17T20:47:52.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-03-11T14:37:53.781Z","etag":null,"topics":["go","golang","local-file","proxy","webapp","websocket","websocket-server"],"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/diegohce.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-04-03T04:36:29.000Z","updated_at":"2024-06-19T09:01:29.015Z","dependencies_parsed_at":"2024-06-19T09:01:28.054Z","dependency_job_id":"b0646c00-122e-44a4-8ae2-2a3b113771e0","html_url":"https://github.com/diegohce/hddproxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegohce%2Fhddproxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegohce%2Fhddproxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegohce%2Fhddproxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/diegohce%2Fhddproxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/diegohce","download_url":"https://codeload.github.com/diegohce/hddproxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245319763,"owners_count":20596032,"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":["go","golang","local-file","proxy","webapp","websocket","websocket-server"],"created_at":"2024-12-02T06:52:22.299Z","updated_at":"2025-03-24T17:40:34.442Z","avatar_url":"https://github.com/diegohce.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HDD Proxy\nHDD Proxy is a dirver for web applications to access small text files on the local hard drive.\nIt runs as a service, preferable listening on `localhost`.\n\n# How does it work\nHDD Proxy offers an endpoint to write files to disk, and has available a websocket to send text files to web browser.\n\n# Environment variables\nExample env variables and their default values.\n```bash\nHDDPROXY_TCP_BIND=\"127.0.0.1:8080\"\nHDDPROXY_LONGPOLL=\"5\"\nHDDROXY_SHORTPOLL=\"1\"\nHDDPROXY_DIRS_SEP=\":\"\nHDDPROXY_DIRS=\"\"\n```\n`HDDPROXY_DIRS` variable is a list of directories separated (by default) with a colon (`:`) as in:\n```bash\nHDDPROXY_DIRS=\"/home/diego/tmp/stuff:/home/diego/tmp/stuff2\"\n```\nThis is the only mandatory variable.\nDirectories separator (`:`) can be changed setting `HDDPROXY_DIRS_SEP` variable.\n\n# Write\nTo write files make an HTTP POST to `http://127.0.0.1:8080/hddproxy/write` \n```json\n{\n    \"body\": \"Hello, World!\",\n    \"dir\": \"/home/diego/tmp/stuff\",\n    \"name\": \"hi.txt\"\n}\n```\nA response with status 200 OK means writing was successful.\n\n# Read\nFor an example on how to read files, see `websockets.html` file.\n\n# Build\nClone this repo and run `go build .`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegohce%2Fhddproxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiegohce%2Fhddproxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegohce%2Fhddproxy/lists"}