{"id":29728587,"url":"https://github.com/anilrajrimal1/sharemydir","last_synced_at":"2025-07-25T02:39:56.857Z","repository":{"id":298675818,"uuid":"990353175","full_name":"anilrajrimal1/sharemydir","owner":"anilrajrimal1","description":"Simple and elegant CLI tool that lets you instantly share any local directory over HTTP. It requires zero configuration and is perfect for quickly transferring files across devices on the same network.","archived":false,"fork":false,"pushed_at":"2025-06-12T08:39:56.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-13T01:34:04.836Z","etag":null,"topics":["cli-tool","file-sharing","http-server","local-network","mobile-access","qr-code","zero-config"],"latest_commit_sha":null,"homepage":"","language":"Python","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/anilrajrimal1.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-05-26T01:49:11.000Z","updated_at":"2025-06-12T08:39:59.000Z","dependencies_parsed_at":"2025-06-12T09:52:29.770Z","dependency_job_id":null,"html_url":"https://github.com/anilrajrimal1/sharemydir","commit_stats":null,"previous_names":["anilrajrimal1/sharemydir"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/anilrajrimal1/sharemydir","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anilrajrimal1%2Fsharemydir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anilrajrimal1%2Fsharemydir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anilrajrimal1%2Fsharemydir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anilrajrimal1%2Fsharemydir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anilrajrimal1","download_url":"https://codeload.github.com/anilrajrimal1/sharemydir/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anilrajrimal1%2Fsharemydir/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266945135,"owners_count":24010493,"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","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli-tool","file-sharing","http-server","local-network","mobile-access","qr-code","zero-config"],"created_at":"2025-07-25T02:39:47.980Z","updated_at":"2025-07-25T02:39:56.847Z","avatar_url":"https://github.com/anilrajrimal1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eShareMyDir\u003c/h1\u003e\n  \u003cp\u003eEffortlessly serve any folder over HTTP with zero configuration.\u003c/p\u003e\n  \u003cp\u003eMobile-friendly interface, QR code access, and downloadable folders as ZIP files.\u003c/p\u003e\n\u003c/div\u003e\n\n\u003c/br\u003e\n\n\u003c!-- prettier-ignore-start --\u003e\n\u003cdiv align=\"center\"\u003e\n\n| **PyPI**                                                                                  | **Python Version**                                                                     | **License**                                                                                                     | **GitHub Release**                                                                                                     | **Downloads**                                                                        |\n| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |\n| [![PyPI](https://img.shields.io/pypi/v/sharemydir?color=blue)](https://pypi.org/project/sharemydir/) | [![Python Version](https://img.shields.io/pypi/pyversions/sharemydir)](https://pypi.org/project/sharemydir/) | [![License](https://img.shields.io/github/license/anilrajrimal1/sharemydir?color=green)](https://github.com/anilrajrimal1/sharemydir/blob/main/LICENSE) | [![GitHub Release](https://img.shields.io/github/v/release/anilrajrimal1/sharemydir?color=purple)](https://github.com/anilrajrimal1/sharemydir/releases) | [![Downloads](https://img.shields.io/pypi/dm/sharemydir?color=orange)](https://pypi.org/project/sharemydir/) |\n\n\u003c/div\u003e\n\n\n## Features\n\n- **Instant HTTP Server**: Serve any folder with a single command.\n- **Automatic IP Detection**: Works seamlessly on your local network.\n- **Mobile-Friendly**: Access via QR code or URL on any device.\n- **Download Folders as ZIP**: Easily share entire directories.\n- **Individual File Downloads**: Grab single files directly from the browser.\n- **Clean Web UI**: Responsive, intuitive interface for all devices.\n- **Zero Config CLI**: No setup, just run and share.\n- **Elegant Terminal Output**: Clear URLs and QR codes for quick access.\n\n## Demo\n![sharemydir-demo](https://github.com/user-attachments/assets/1585ee4b-0d05-48b7-bd55-862650a96ed8)\n\n## Installation\n\nInstall `sharemydir` directly from PyPI:\n\n```bash\npip install sharemydir\n```\n\nAlternatively, clone the repository for development:\n\n```bash\ngit clone https://github.com/anilrajrimal1/sharemydir.git\ncd sharemydir\n```\n### Dependencies\n\n- Requires `qrcode` for QR code generation:\n  ```bash\n  pip install qrcode\n  ```\n\n## Usage\n\nServe the current directory:\n\n```bash\nsharemydir\n```\n\nServe a specific folder on a custom port:\n\n```bash\nsharemydir /path/to/folder -p 9000\n```\n\n### Example Output\n\n```text\n+------------------------------------------------------------+\n| Serving folder: /home/anil/demo/sharemydir-demo               |\n| URL: http://192.168.1.42:9000/                             |\n| Scan this QR code for mobile access:                       |\n+------------------------------------------------------------+\n```\n\nOpen the URL in a browser or scan the QR code on your mobile device.\n\n## Web Interface\n\n- **Table View**: Clean, organized display of files and folders.\n- **Download Options**: Buttons for downloading files or entire folders as ZIP.\n- **Responsive Design**: Optimized for desktops, tablets, and phones.\n\n## CLI Options\n\n| Option         | Description                           | Default       |\n|----------------|---------------------------------------|---------------|\n| `FOLDER`       | Folder to serve                       | Current (`.`) |\n| `-p`, `--port` | Port for the server                   | `8080`        |\n\n## Graceful Shutdown\n\nStop the server cleanly with `Ctrl+C`.\n\n## Development\n\nTo run locally for development:\n\n```bash\npython sharemydir.py\n```\n\n### Contributing\n\nWe welcome contributions! To get started:\n\n1. Fork the repository.\n2. Create a feature branch (`git checkout -b feat/name-your-feature`).\n3. Commit your changes (`git commit -m 'add amazing feature'`).\n4. Push to the branch (`git push origin feat/name-your-feature`).\n5. Open a Pull Request.\n\n## Releases\n\nCheck out the [Releases](https://github.com/anilrajrimal1/sharemydir/releases) page for the latest updates, changelogs, and version history.\n\n- **Latest Release**: [v1.0.3](https://github.com/anilrajrimal1/sharemydir/releases/latest)\n- Available on [PyPI](https://pypi.org/project/sharemydir/).\n\n## License\n\nDistributed under the MIT License. © 2025 Anil Raj Rimal. See [LICENSE](LICENSE) for more information.\n\n## Acknowledgments\n\n- Built with 💖 by [Anil Raj Rimal](https://github.com/anilrajrimal1).\n- Powered by Python and open-source libraries.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanilrajrimal1%2Fsharemydir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanilrajrimal1%2Fsharemydir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanilrajrimal1%2Fsharemydir/lists"}