{"id":22400729,"url":"https://github.com/monyasau/polyshare","last_synced_at":"2025-10-15T17:30:42.101Z","repository":{"id":257305363,"uuid":"857872880","full_name":"monyasau/PolyShare","owner":"monyasau","description":"A Blazingly Fast, Open Source Cross-Platform Local Network File Sharing","archived":false,"fork":false,"pushed_at":"2024-12-18T22:06:57.000Z","size":128,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T13:12:04.502Z","etag":null,"topics":["cross-platform","expressjs","html","javascript","js","markdown","md","network","nodejs","open-source","tailwind","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/monyasau.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2024-09-15T20:26:51.000Z","updated_at":"2024-12-18T22:07:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"6b9215e5-d9d5-49db-8000-4a642cf43a6c","html_url":"https://github.com/monyasau/PolyShare","commit_stats":null,"previous_names":["monyasau/file-share-app","monyasau/polyshare"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/monyasau/PolyShare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monyasau%2FPolyShare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monyasau%2FPolyShare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monyasau%2FPolyShare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monyasau%2FPolyShare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monyasau","download_url":"https://codeload.github.com/monyasau/PolyShare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monyasau%2FPolyShare/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279096105,"owners_count":26102482,"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-10-15T02:00:07.814Z","response_time":56,"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":["cross-platform","expressjs","html","javascript","js","markdown","md","network","nodejs","open-source","tailwind","tailwindcss"],"created_at":"2024-12-05T08:14:19.378Z","updated_at":"2025-10-15T17:30:41.705Z","avatar_url":"https://github.com/monyasau.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polyshare\n\n**Description**:  A local-network file share system:\n\nPolyShare: Fast, Cross-Platform Local Network File Sharing\n\n\n\n  - **Technology stack**: HTML, CSS, Javascript, NodeJS\n  - **Status**:  still in development, Beta version available [CHANGELOG](CHANGELOG.md).\n\n## Installation\n\n**Refer to [INSTALL](INSTALL.md) document.**\n\nInstallation is straight forward non persistent process, run the executable in any directory/folder and polyshare will create a folder called \"shared_files\" there, any files in the \"shared_files\" folder will become sharable. you can also add files to the folder by uploading via browser interface.\n\n\n## 🤝 How can you help build?\n\n1. Fork this repo\n2. Create your feature branch (`git checkout -b my-new-super-feature`)\n3. Commit your changes (`git commit -am 'Add some cool feature'`)\n4. Push to the branch (`git push origin my-new-super-feature`)\n5. Create a new pull request\n\n# Building the executables\n\n## Executable Generation\n\nThis project uses `pkg` to generate executables for different platforms. Below are the commands to generate the binaries for **Windows (32-bit and 64-bit)**, **Linux (32-bit and 64-bit)**, and **macOS (64-bit and ARM64)**.\n\n### Prerequisites\n\nEnsure that `pkg` is installed globally on your system:\n```\nnpm install -g pkg\n```\n\nTo generate the 64-bit binaries/executables for **Windows**, **Linux**, and **macOS**.\n\n```\npkg  --targets node16-win-x64,node16-linux-x64,node16-macos-x64 --output polyShare\n```\nor simply ``npm run build``\nThis will create the following executables:\n - ``polyShare-win-x64.exe`` for Windows 64-bit\n - ``polyShare-linux-x64`` for Linux 64-bit\n - ``polyShare-macos-x64`` for macOS 64-bit\n\n\n**Generating Specific Executables**\nTo generate platform-specific executables, run the following commands.\n\n**1. Windows 64-bit Executable**\n\n```\npkg  --targets node16-win-x64 --output polyShare-win-x64.exe\n```\n**2. Windows 32-bit Executable**\n```\npkg  --targets node16-win-x86 --output polyShare-win-x86.exe\n```\n**3. Linux 64-bit Executable**\n```\npkg  --targets node16-linux-x64 --output polyShare-linux-x64\n```\n**4. Linux 32-bit Executable**\n```\npkg  --targets node16-linux-x86 --output polyShare-linux-x86\n```\n**5. macOS 64-bit Executable**\n```\npkg  --targets node16-macos-x64 --output polyShare-macos-x64\n```\n**6. macOS ARM64 Executable (for Apple M1/M2 chips)**\n```\npkg  --targets node16-macos-arm64 --output polyShare-macos-arm64\n```\n\n\n## Dependencies\n\nNo dependencies as the ones needed are bundled with the executable\n\n## Configuration\n\nThe web port is configurable with a .env file in the root directory\n\n## Usage\n\nAfter downloading the executable, simply run the executable file for your operating system, and PolyShare will start a local server for file sharing within the network.\n### Run PolyShare, By:\n#### Gui:\n Double click the executable file.\n\n#### CLI/Terminal:\n\n- On Windows: ``./polyShare-win-x64.exe``\n- On Linux: ``./polyShare-linux-x64``\n- On macOS: ``./polyShare-macos-x64``\n\n## Key Features\n\n- **File sharing up to 100 GB+:** Easily transfer files of any size, with the limit set by your network's bandwidth and storage capacity.\n\n- **High-speed transfer:** Achieve upload and download speeds up to 450+ MB/s, making it ideal for large file transfers.\n- **Cross-platform support:** Seamless file sharing across Android, IOS, Windows, Linux, and macOS.\n\n- **Simple UI**: Intuitive, browser-based interface to upload and download files, view transfer history, and manage settings.\n- **Resume interrupted transfers:** Allows resumption of file transfers in case of interruption.\n\n## Additional Features\n\n- **No internet connection needed:** PolyShare works over the local network, making it a secure and offline solution for file transfers.\n- **Drag-and-drop support:** Easily drag files directly into the browser window for instant sharing.\n- **Real-time progress updates:** Track file transfer progress with real-time updates in the browser UI.\n\n## Known Issues\n\n**Network firewall restrictions:** In some environments( first time run on windows), firewalls may block local file sharing. Ensure proper configuration of your firewall on host device to allow PolyShare traffic.\n\n**macOS permissions:** On macOS, you may need to grant permissions for network file sharing in the system preferences.\n\n## Getting help\n\n...\nIf you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.\n\n## Getting involved\n\n... [CONTRIBUTING](CONTRIBUTING.md).\n\n## Why i built this\n\nI went through hell trying to transfer stuffs from my windows device to ios and a couple other devices,\nso i built PolyShare to offer a fast, user-friendly way of sharing large files across devices on the same network without relying on third-party cloud services or external storage. Its speed and simplicity make it ideal for local file sharing in offices, homes, and educational environments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonyasau%2Fpolyshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonyasau%2Fpolyshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonyasau%2Fpolyshare/lists"}