{"id":13588869,"url":"https://github.com/bastibl/instant-gnuradio","last_synced_at":"2026-02-28T04:04:02.665Z","repository":{"id":28853790,"uuid":"117410180","full_name":"bastibl/instant-gnuradio","owner":"bastibl","description":"Customizable GNU Radio Environment for Live Images and VMs","archived":false,"fork":false,"pushed_at":"2024-05-27T06:11:46.000Z","size":11635,"stargazers_count":169,"open_issues_count":2,"forks_count":34,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-04T16:28:02.096Z","etag":null,"topics":["gnuradio","gqrx","sdr","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bastibl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-01-14T07:13:28.000Z","updated_at":"2025-03-31T14:05:38.000Z","dependencies_parsed_at":"2023-11-17T08:54:35.984Z","dependency_job_id":"4a5e7fdf-eae4-48a7-83ee-daf063fcaf1f","html_url":"https://github.com/bastibl/instant-gnuradio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bastibl/instant-gnuradio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bastibl%2Finstant-gnuradio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bastibl%2Finstant-gnuradio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bastibl%2Finstant-gnuradio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bastibl%2Finstant-gnuradio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bastibl","download_url":"https://codeload.github.com/bastibl/instant-gnuradio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bastibl%2Finstant-gnuradio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29924719,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"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":["gnuradio","gqrx","sdr","ubuntu"],"created_at":"2024-08-01T15:06:59.860Z","updated_at":"2026-02-28T04:04:02.651Z","avatar_url":"https://github.com/bastibl.png","language":"Vim Script","funding_links":[],"categories":["Vim Script","Tools"],"sub_categories":["Pentesting Operating Systems"],"readme":"# Instant GNU Radio\n\nA customizable, programmatically generated VM and live environment for GNU Radio. [Download](https://nextcloud.seemoo.tu-darmstadt.de/s/4brQXPgLmL582dn) the VM and get started!\n\n![Screenshot](screen2.png)\n\n## Requirements\n\n- Requires **VirtualBox 7.X** to build.\n\n## Main Features\n\n- OVA VM appliance can be imported in all main virtualization solutions or `dd`ed on a USB drive.\n- Based on Ubuntu 22.04.1 w/ GNOME 3.\n- Two step build process: first create a base image, then extend it with SDR stuff.\n- Easy to brand for your own courses/workshops. Just replace the wallpaper in the `assets` folder, for example.\n- Software: GNU Radio, GQRX, ...\n- Fosphor support!\n- Hardware: HackRF, RTL-SDR, BladeRF, Pluto, UHD; properly setup with udev rules and downloaded images.\n- Productivity: Git, Meld, VIM, ...\n- Favorite applications (in the sidebar) are set to GNU Radio Companion, GQRX, GNU Radio Wiki, ...\n- Sane VM defaults (USB, 3D acceleration, audio, shared clipboard, etc.).\n- Ready for offline use.\n- CPU governors are set to *performance*.\n- No annoying crash reports dialogs.\n- No screen blanking.\n- No `sudo` password.\n\n## Credentials\n\n``` bash\nuser: sdr\npassword: sdr\n```\n\n### SSH Login\n\n``` bash\nssh -p2222 sdr@localhost\n```\n\nPassword is `sdr`.\n\nYou might want to add something like this to your SSH config (`~/.ssh/config`):\n\n``` bash\nHost vm\n\tHostname localhost\n\tUser sdr\n\tPort 2222\n\tUserKnownHostsFile /dev/null\n\tStrictHostKeyChecking no\n```\n\nWith this config, you can login with `ssh vm` and your password.\n\n## VMWare\n\nVirtualBox and VMWare use different network interfaces, which results in different names for the Ethernet controller. If the network is not automatically configured use `ip link show` to figure out the device name of the interface and adapt the `ethernets` section of `/etc/netplan/01-netcfg.yaml` accordingly. \n\n\n\n\n## Customization\n\nIf you want to rebuild and customize the environment, read on...\n\n### Prerequisites\n\nInstant GNU Radio requires packer and VirtualBox including the Extension Pack.\n\nOn Debian-like systems, the following packets will do the trick:\n\n```bash\nsudo apt install packer\nsudo apt install virtualbox virtualbox-ext-pack\n```\n\nOn Ubuntu, your user should be in the `vboxusers` group.\n\n``` bash\nsudo usermod -a -G vboxusers \u003cyour username\u003e\n```\n\nYou have to logout and login again for the changes to take effect.\n\n### Create Image\n\nNote: You have to be online to build the image.\n\nThen, just run:\n\n``` bash\nconfigure\n``` \n\nto check if all dependencies are satisfied. Once `configure` has successfully run, type\n\n``` bash\nmake\n```\n\nto build the virtual machine. The output will be in the `vms/` directory.\n\nNote that there is a `base` file and a `sdr` file. If you make changes to your `sdr.json` you can save time by only rebuilding the latter by running `make sdr`.\n\n### Customizing the Virtual Machines\n\nVM configurations are defined in the packer configuration files `base.json` and `sdr.json`.\n\nMore information on how to customize the virtual machines can be found on the [packer website](https://www.packer.io/).\n## Live Image\n\nTBD. See the `gen_iso.sh` and `chroot.sh` script.\n\n## More Screenshots\n![Screenshot](screen1.png)\n![Screenshot](screen3.png)\n![Screenshot](screen4.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbastibl%2Finstant-gnuradio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbastibl%2Finstant-gnuradio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbastibl%2Finstant-gnuradio/lists"}