{"id":28506691,"url":"https://github.com/medowic/filelink","last_synced_at":"2026-04-30T19:31:26.679Z","repository":{"id":297972910,"uuid":"996934024","full_name":"medowic/filelink","owner":"medowic","description":"Fast data transfer and secure access in your browser","archived":false,"fork":false,"pushed_at":"2025-07-20T03:37:27.000Z","size":560,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-20T05:44:34.251Z","etag":null,"topics":["file-sharing","linux","web","windows"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/medowic.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}},"created_at":"2025-06-05T17:29:29.000Z","updated_at":"2025-07-20T03:37:30.000Z","dependencies_parsed_at":"2025-07-20T05:12:10.182Z","dependency_job_id":"1be298e3-7842-4f8b-9b04-b9566e837cc9","html_url":"https://github.com/medowic/filelink","commit_stats":null,"previous_names":["medowic/filelink"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/medowic/filelink","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medowic%2Ffilelink","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medowic%2Ffilelink/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medowic%2Ffilelink/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medowic%2Ffilelink/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/medowic","download_url":"https://codeload.github.com/medowic/filelink/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/medowic%2Ffilelink/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32475191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"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":["file-sharing","linux","web","windows"],"created_at":"2025-06-08T20:06:12.047Z","updated_at":"2026-04-30T19:31:26.672Z","avatar_url":"https://github.com/medowic.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"/github/logo_github.svg\" alt=\"Filelink\" width=\"500\"\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/medowic/filelink/blob/main/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/badge/License-MIT-FF64FF?logo=github\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cstrong\u003eFast data transfer and secure access in your browser\u003c/strong\u003e\u003c/p\u003e\n\n#\n\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"/github/demo_success.png\" alt=\"Demo\" width=\"1000\"\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003eShare your folder with files with self-hosted server, locally or worldwide just in browser\u003c/p\u003e\n\n# Why Filelink?\n- **Self-hosted**: run it right on your PC\n- **Easy to use**: [4 steps](#how-to-use) to get access to the files\n- **Lightweight**: less than `1 MB` - you can take it anywhere!\n- **Cross-platform**: Windows or Linux\n- **Secure**: nobody can get access without a passkey\n- **No limits**: share and download as many files as you want\n\n# How to use?\n## As client (user):\n1. Open the link where Filelink is hosted in your browser\n2. Click to `show files` button\n3. Enter the passkey that you received from host\n4. Get access to the folder and start downloading!\n\n\u003e [!TIP]\n\u003e Also, you can use the `?passkey=` key in link for direct access to the folder or to the file download\n\n### Direct access (with auto-auth)\nTo get direct access to the folder you need to set passkey on`/access` page after `?passkey=`\n\n**For example:**\n```\nhttp://localhost:8080/access?passkey=enter-passkey\n```\n\nTo download file direcly (without visit Filelink home page) you need to set passkey on `/download/[filename]` link after `?passkey=`\n\n**For example:**\n```\nhttp://localhost:8080/download/your-file?passkey=enter-passkey\n```\n\n\u003e [!IMPORTANT]\n\u003e Get direct access may be only on `/access` and `/download/[filename]` pages\n\n## As server (host):\n1. [Install](#installation) Filelink Server\n2. Locate your files into standard `files` directory where Filelink is located or locate files in a path that you have set in `config/config.yaml` (see [Configuration](#configuration))\n3. [Run](#start) Filelink Server\n4. Share passkey with users\n\n# Installation\n### Requirements:\n- `python3` with `pip3`\n\u003e [!NOTE]\n\u003e Also, this project based on `Flask` and `Waitress`\n## Windows\n1. Download source code or clone repository by using `git`\n```\ngit clone https://github.com/medowic/filelink.git\n```\n2. Open the terminal in the folder where Filelink is located and install dependencies from the `requirements.txt` file\n```\npip install -r requirements.txt\n```\n\u003e [!TIP]\n\u003e Also, you can use the `setup.cmd`, located in the same directory, for automatic installation\n\u003e \n\u003e **It makes the same things**\n\n## Linux\n1. Clone repository\n\u003e [!WARNING]\n\u003e Installing using `git clone` include support for automatic updates using `git` or scripts\n\u003e\n\u003e It's not recommended to install Filelink without `git`\n```sh\ngit clone https://github.com/medowic/filelink.git\n```\n2. Move to the directory where Filelink is located and install dependencies from `requirements.txt`\n```sh\ncd filelink\npip3 install -r requirements.txt\n```\n\u003e [!IMPORTANT]\n\u003e For global-wide install, use `--break-system-packages`\n```sh\npip3 install -r requirements.txt --break-system-packages\n```\n\u003e [!IMPORTANT]\n\u003e Also, on some Debian-based systems with `apt`, Flask can't be installed using `pip3`\n\u003e\n\u003e To install it, use `apt`\n```sh\napt install python3-flask\n```\n\u003e [!TIP]\n\u003e Also, you can use the `setup.sh`, located in the same directory, for automatic installation\n\u003e \n\u003e **It makes the same things**\n```sh\nchmod +x setup.sh\n./setup.sh\n```\nFor global-wide install of dependencies, use `--break-system-packages`:\n```sh\n./setup.sh --break-system-packages\n```\n\n### Install as daemon\nIf you need a daemon to run Filelink as a background task (e. g. on a server), see [Filelink Daemon repository](https://github.com/medowic/filelink-daemon)\n\nInstallation and how-to-run instructions will be provided there\n\n# Start\nIn the parent directory, find the `run.py` file and run it\n## Windows\n```\npython run.py\n```\n\u003e [!TIP]\n\u003e Also, in the same directory, you can find the `start.cmd` file for quick running in a separate window\n## Linux\n```sh\npython3 run.py\n```\n\n\u003e [!NOTE]\n\u003e By default, the server will start at `0.0.0.0:8080`. You can change this in `config/config.yaml` (see [Configuration](#configuration))\n\n# Setting up using arguments\nIn any system you can setting up Filelink using arguments\n### Set folder for file sharing\nUse `-f` or `--folder` option\n```\n\u003e run.py -f /path/to/files\n```\n```\n\u003e run.py --folder /path/to/files\n```\n### Disable update check\nUse `-o` or `--no-updates` option\n```\n\u003e run.py -o\n```\n```\n\u003e run.py --no-updates\n```\n\n# Configuration\nIn `config/config.yaml`, you can change some settings\n## Server\n### Address\nSet what adresses will be listen by server:\n```yaml\nserver:\n  address: 0.0.0.0 # all addresses\n```\n### Port\nSet port:\n```yaml\nserver:\n  port: 8080\n```\n## Custom\nThere you can set some user parameters\n\nIf the `custom` parameter is not set, all these settings are will be created automatically or generated by Filelink\n### Passkey\nSet passkey, if you need customize it. If not specified, the auto-generated string will contain 64 characters\n```yaml\ncustom:\n  passkey: some-passkey\n```\n### Username\nSet the username, which will be indicated in the line `Hosted by:` on website. If not specified, the auto-generated string will contain the username from your machine\n```yaml\ncustom:\n  username: filelink-user\n```\n### Path\nSet the path to be used for file sharing. If not specified, the `files` directory will be used by default.\n```yaml\ncustom:\n  path: /path/to/files\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmedowic%2Ffilelink","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmedowic%2Ffilelink","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmedowic%2Ffilelink/lists"}