{"id":17271685,"url":"https://github.com/smartfinn/eve-ng-integration","last_synced_at":"2025-04-08T09:08:57.782Z","repository":{"id":45706502,"uuid":"54658516","full_name":"SmartFinn/eve-ng-integration","owner":"SmartFinn","description":"integrates EVE-NG (aka UNetLab) with Linux desktop","archived":false,"fork":false,"pushed_at":"2025-02-03T12:44:57.000Z","size":1189,"stargazers_count":355,"open_issues_count":16,"forks_count":119,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-04-01T08:34:25.028Z","etag":null,"topics":["eve-ng","linux","telnet","unetlab","url-handler"],"latest_commit_sha":null,"homepage":"http://git.io/eve-ng-integration","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/SmartFinn.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}},"created_at":"2016-03-24T16:50:00.000Z","updated_at":"2025-03-26T09:19:24.000Z","dependencies_parsed_at":"2025-03-18T05:11:06.274Z","dependency_job_id":"860df33b-1c2b-4d26-87ad-0fc61028aee6","html_url":"https://github.com/SmartFinn/eve-ng-integration","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartFinn%2Feve-ng-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartFinn%2Feve-ng-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartFinn%2Feve-ng-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SmartFinn%2Feve-ng-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SmartFinn","download_url":"https://codeload.github.com/SmartFinn/eve-ng-integration/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247809962,"owners_count":20999816,"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":["eve-ng","linux","telnet","unetlab","url-handler"],"created_at":"2024-10-15T08:46:06.742Z","updated_at":"2025-04-08T09:08:57.757Z","avatar_url":"https://github.com/SmartFinn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EVE-NG Integration [![releases](https://img.shields.io/github/release/smartfinn/eve-ng-integration.svg)](https://github.com/SmartFinn/eve-ng-integration/releases)\n\nThis repo contains the equivalent of EVE-NG (aka UNetLab) [Windows Client Side Pack](http://www.eve-ng.net/index.php/downloads/windows-client-side-pack) for Ubuntu/Debian and other Linux distros.\n\nCurrently supports the following URL schemes:\n\n* `telnet://`\n* `capture://`\n* `docker://`\n* `vnc://` _(via Vinagre)_\n\nIncludes a script to work with .rdp files that are generated by EVE-NG.\n\n## Demo\n\n![Demo](demo.gif)\n\n## Installation\n\n### Ubuntu and derivatives\n\nYou can install eve-ng-integration from the official [PPA](https://launchpad.net/~smartfinn/+archive/ubuntu/eve-ng-integration):\n\n```\nsudo add-apt-repository ppa:smartfinn/eve-ng-integration\nsudo apt-get update\nsudo apt-get install eve-ng-integration\n```\n\nor download .deb packages from [here](https://launchpad.net/~smartfinn/+archive/ubuntu/eve-ng-integration/+packages).\n\n### Install script\n\nAlternatively, you can install eve-ng-integration from terminal using the following command:\n\n```\nwget -qO- https://raw.githubusercontent.com/SmartFinn/eve-ng-integration/master/install.sh | sh\n```\n\nThis method works on most Linux distros. Tested on **Arch Linux**, **Manjaro**, **Fedora**, **openSUSE**, **CentOS**, and potentially works with other systems.\n\nIf your Linux distribution is not supported yet, don't give up, try [Manual install](#manual-install) or [open a new issue](https://github.com/SmartFinn/eve-ng-integration/issues/new).\n\n### Unofficial packages\n\nPackages in this section are not part of the official repositories. If you have a problem or a question, please contact the package maintainer.\n\n| **Distro** | **Maintainer**  | **Package**                              |\n| :--------- | :-------------- | :--------------------------------------- |\n| Arch Linux | Konstantin Shalygin | [eve-ng-integration](https://aur.archlinux.org/packages/eve-ng-integration) \u003csup\u003eAUR\u003c/sup\u003e |\n\n**NOTE:** If you are a maintainer and want to be in the list, please create an issue or make a pull request.\n\n#### Manual install\n\n1. Clone this repo\n\n  ```\n  git clone https://github.com/SmartFinn/eve-ng-integration.git\n  ```\n  or download and extract the tarball\n  ```\n  wget -O eve-ng-integration.tar.gz https://github.com/SmartFinn/eve-ng-integration/archive/master.tar.gz\n  tar -xzvf eve-ng-integration.tar.gz\n  ```\n\n2. Run `make install` as root\n\n  ```\n  cd eve-ng-integration/\n  sudo make install\n  ```\n\n3. Install dependencies\n\n  * `python3` _(required)_\n  * `telnet` _(required)_\n  * `wireshark` _(recommended)_\n  * `ssh-askpass` _(recommended)_\n  * `vinagre` _(recommended)_\n  * `docker` _(optional)_\n\n4. Enjoy!\n\n## Known issues\n\n1. #### Error `Couldn't run /usr/bin/dumpcap in child process: Permission denied` when starting Wireshark\n\n    Add your user to `wireshark` group:\n\n    ```\n    sudo usermod -a -G wireshark $USER\n    ```\n\n    If you use a Debian-like distro, you can run the next command and choose answer as `Yes`:\n\n    ```\n    sudo dpkg-reconfigure wireshark-common\n    ```\n\n    You will need to log out and then log back in again for this change to take effect.\n\n2. #### Error `End of file on pipe magic during open` when starting Wireshark\n\n    Install `ssh-askpass` package for your distro, or setup SSH key-based authentication with EVE-NG (UNetLab) machine.\n\n3. #### Click on a node does not open an app (opens another app) in all browsers\n\n    Execute the following commands to set the `eve-ng-integration.desktop` as default handler for telnet, capture, and docker URL schemes:\n\n    ```bash\n    mkdir -p ~/.local/share/applications/\n    xdg-mime default eve-ng-integration.desktop x-scheme-handler/capture\n    xdg-mime default eve-ng-integration.desktop x-scheme-handler/telnet\n    xdg-mime default eve-ng-integration.desktop x-scheme-handler/docker\n    xdg-mime default eni-rdp-wrapper.desktop application/x-rdp\n    ```\n\n4. #### Does not work in Google Chrome but works in another browser\n\n    Quit Chrome and reset protocol handler with the command:\n\n    ```bash\n    sed -i.orig 's/\"\\(telnet\\|capture\\|docker\\)\":\\(true\\|false\\),\\?//g' \"$HOME/.config/google-chrome/Default/Preferences\"\n    ```\n\n    **NOTE**: Path to the `Preferences` file will be different for Chromium and other Chromium-based browsers.\n\n5. #### Does not work in Firefox but works in another browser\n\n    Go to `Preferences → Applications` (or paste `about:preferences#applications` in your address bar) and change Action to `Always ask` for telnet, capture and docker Content Types.\n\n6. #### Firefox says `The address wasn't understood` when you clicked on a node\n\n    - Type `about:config` into the Location Bar (address bar) and press Enter.\n    - Right-click → New → Boolean → Name: `network.protocol-handler.expose.telnet` → Value → `false` (Repeat this for each supported protocol)\n    - Next time you click a link of protocol-type foo you will be asked which application to open it with.\n\n    See also [http://kb.mozillazine.org/Register_protocol](http://kb.mozillazine.org/Register_protocol#Firefox_3.5_and_above)\n\n7. #### Chrome/Chromium downloads RDP files instead of opening\n\n    To make RDP file open on your browser, instead of downloading, you have to download the file type once, then right after that download, look at the status bar at the bottom of the browser. Click the arrow next to that file and choose \"Always open files of this type\". Done.\n\n    See also https://stackoverflow.com/a/24290187/1446494\n\nIf your problem hasn't been solved or reported, please [open a new issue](https://github.com/SmartFinn/eve-ng-integration/issues).\n\nEnglish, Russian, and Ukrainian are welcomed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartfinn%2Feve-ng-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmartfinn%2Feve-ng-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmartfinn%2Feve-ng-integration/lists"}