hop README

The project's README from github.com/Arjun-Ingole/hop. As one markdown file: README.md.

hop

Install Linux next to Windows without a USB stick.

The hop window: install elementary OS next to Windows, with 120 GB, above a bar showing drive C: split between Windows and Linux

What it is

hop is a single Windows app that installs Linux alongside Windows. Pick a system, choose a drive, drag to choose how much space it gets, and click Install. There's no USB stick to find and nothing to install first.

What it does

Systems: elementary OS, Ubuntu and its flavours (Budgie, Xubuntu, Lubuntu, Cinnamon, Unity, Edubuntu, Studio), Linux Mint, Pop!_OS, Zorin OS, Debian, Fedora Workstation, Ultramarine, CachyOS, Arch Linux and Omarchy. Other Ubuntu-based ISOs should work too, if you choose the file yourself. Kubuntu isn't supported, because its ISO has a file too big for FAT32. CachyOS, Arch, Omarchy and Pop!_OS need Secure Boot off. Omarchy also needs BitLocker fully off on its disk, not paused, and hop refuses until it is. hop won't turn it off for you.

Needs: Windows 10 (1803 or newer) or 11, on a UEFI PC with a GPT disk, which is nearly every PC sold with them. Linux has to go on a disk inside the PC, not a USB drive.

How it works

A USB installer is just a FAT32 drive with the ISO's files on it. hop makes the same thing on your internal disk:

Before   [ EFI ][ C: Windows                              ][ Recovery ]
After    [ EFI ][ C: Windows       ][ Installer ][ Linux  ][ Recovery ]
  1. Download and check the ISO, and confirm it's a system hop can install.
  2. Make room after the drive you chose, using free space first and shrinking the drive only if needed.
  3. Copy the ISO's files onto a small FAT32 partition, and check each one.
  4. Add a startup entry with the ISO's signed boot loader, for the next restart only.
  5. Restart. The Linux installer opens and installs into the space hop made.

More detail is in How hop works.

Use it

Download hop.exe from Releases and run it. Windows asks for administrator access, and SmartScreen may warn because hop isn't code-signed yet: click More info → Run anyway.

If something goes wrong, see Troubleshooting.

Build it

You need the .NET SDK, on any OS. The result is bin/Release/hop.exe.

dotnet build -c Release

See Contributing to help, or to add a Linux system.

License

MIT. Instrument Sans is under the SIL Open Font License. Linux logos belong to their projects and are listed in SOURCES.md. hop isn't affiliated with any of them.

hop (Arjun-Ingole/hop)

Searching Database…

707 ·GitHub

hop is a single Windows app that installs Linux alongside Windows. Pick a system, choose a drive, drag to choose how much space it gets, and click Install. There's no USB stick to find and nothing to install first.

Size
0.9 MB
Stars
707
Updated
CommitOct 31
Age
1d
Commits · 90 Days