{"id":50002415,"url":"https://github.com/luc-github/netneighbor","last_synced_at":"2026-05-30T06:04:27.697Z","repository":{"id":358471387,"uuid":"1223393465","full_name":"luc-github/NetNeighbor","owner":"luc-github","description":" NetNeighbor is a Linux desktop application that replicates and extends the Windows Network","archived":false,"fork":false,"pushed_at":"2026-05-18T11:30:47.000Z","size":161454,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T14:23:09.590Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/luc-github.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING_ICONS.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T09:27:57.000Z","updated_at":"2026-05-07T12:35:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/luc-github/NetNeighbor","commit_stats":null,"previous_names":["luc-github/netneighbor"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/luc-github/NetNeighbor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2FNetNeighbor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2FNetNeighbor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2FNetNeighbor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2FNetNeighbor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luc-github","download_url":"https://codeload.github.com/luc-github/NetNeighbor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luc-github%2FNetNeighbor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33420660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"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":[],"created_at":"2026-05-19T13:17:39.550Z","updated_at":"2026-05-24T04:01:04.274Z","avatar_url":"https://github.com/luc-github.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NetNeighbor\n\nNetNeighbor is a Linux desktop application that discovers and monitors devices on your\nlocal network — a modern equivalent of the Windows Network Neighborhood experience.\n\n**Current release: 1.0.0**\n\n![NetNeighbor main window](docs/screenshots/overview-hero.png)\n\n## Features\n\n- **Automatic discovery** — SSDP, mDNS/Bonjour, WS-Discovery, NetBIOS; no active port scan\n- **Instant startup** — previously-seen devices appear from cache in \u003c 100 ms\n- **List and icon grid** views with sidebar categories (by type or location)\n- **Open devices** in one click — HTTP, HTTPS, SMB, SSH, FTP, SFTP, Telnet with configurable priority\n- **Per-device overrides** — custom name, type, location, icon, and connection commands\n- **System tray** — minimize to tray, start minimized, session autostart\n- **Localised** — French, Spanish, German, Italian, Dutch, Japanese, Chinese (Simplified/Traditional)\n- **Packaged** as `.deb` (Ubuntu/Mint/Debian), `.AppImage`, and tarball\n\n## Download\n\nLatest release: [GitHub Releases](https://github.com/luc-github/NetNeighbor/releases)\n\nAvailable formats: `.deb` · `.AppImage` · `.tar.gz`\n\n## Requirements\n\n- Linux desktop with GTK 3\n- Python 3.10+\n\n### Ubuntu / Linux Mint / Debian\n\n```bash\nsudo apt install -y python3-gi python3-gi-cairo gir1.2-gtk-3.0\nsudo apt install -y samba-common-bin                             # NetBIOS names\nsudo apt install -y gir1.2-ayatanaappindicator3-0.1             # system tray\n```\n\nThese dependencies are installed automatically when using the `.deb` package.\n\n## Install\n\n**`.deb` package (recommended):**\n```bash\nsudo dpkg -i netneighbor_1.0.0_amd64.deb\n```\n\n**`.AppImage`:**\n```bash\nchmod +x NetNeighbor-1.0.0-x86_64.AppImage\n./NetNeighbor-1.0.0-x86_64.AppImage\n```\n\n**Tarball:**\n```bash\ntar -xzf netneighbor-1.0.0.tar.gz\ncd netneighbor-1.0.0\nbash install-user-desktop.sh   # optional: add menu shortcut\nbash run.sh\n```\n\n## Run from source\n\n```bash\npython -m venv .venv --system-site-packages\nsource .venv/bin/activate\npip install -r requirements.txt\npython main.py\n```\n\nDemo data is enabled by default. Disable with:\n```bash\nNETNEIGHBOR_DEMO=0 python main.py\n```\n\n## Documentation\n\nUser documentation: [`USER_DOCUMENTATION.md`](USER_DOCUMENTATION.md)\n\nDeveloper documentation: [`docs/README.md`](docs/README.md)\n\n## Translations\n\n| Language | Code | Status |\n|----------|------|--------|\n| French | `fr` | Complete |\n| Italian | `it` | Complete |\n| Spanish | `es` | Complete |\n| German | `de` | Complete |\n| Dutch | `nl` | Complete |\n| Traditional Chinese | `zh_TW` | Complete |\n| Simplified Chinese | `zh_CN` | Complete |\n| Japanese | `ja` | Complete |\n\nCompile after editing a `.po` file:\n```bash\nmsgfmt locale/fr/LC_MESSAGES/netneighbor.po -o locale/fr/LC_MESSAGES/netneighbor.mo\n```\n\nTest in a specific language:\n```bash\nLANG=fr_FR.UTF-8 python main.py\n```\n\nFull i18n workflow: [`docs/I18N.md`](docs/I18N.md)\n\n## Autodetection and corrections\n\nDevice names and types are inferred from protocol announcements — they are best-effort.\nUse right-click → **Type / Rename / Location / Icon** for per-device corrections.\nCommunity rule overlays: [`docs/COMMUNITY_OVERRIDES.md`](docs/COMMUNITY_OVERRIDES.md).\n\n## Pending work\n\n[`docs/TODO.md`](docs/TODO.md)\n\nContribution and maintenance notes: [`docs/MAINTENANCE.md`](docs/MAINTENANCE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluc-github%2Fnetneighbor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluc-github%2Fnetneighbor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluc-github%2Fnetneighbor/lists"}