Skip to content
This repository has been archived by the owner on Jan 21, 2024. It is now read-only.
/ winbuntu Public archive

Makes creating and managing a Linux environment through the Windows 10 WSL easy

License

Notifications You must be signed in to change notification settings

serialphotog/winbuntu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Winbuntu - The Ubuntu Linux Environment for Windows 10

Recent insider builds of Microsft's Windows 10 includes a system that they call The Windows Subsystem for Linux (WSL). This is a really cool system that allows you to run linux binaries on Windows 10, without using virtual machines or emulators. The Winbuntu project (Windows + Ubuntu = Winbuntu) aims to help blur the lines between Linux and Windows by making it super easy to set up an awesome Linux system on your Windows 10 install.

How it works

To use Winbuntu, you will first need to set up WSL. You will then be able to launch Winbuntu by running the linux.bat batch script. Doing so will launch a local X server (needed for the graphical environment) and then pass control over to environment.sh, which will configure everything and launch our Linux GUI.

Setting things up

To get started, you will need to download and run the Winbuntu Installer. This is just a simple Windows installer that sets up Xming and install the Winbuntu files.

For this to be at all useful, you will need a git repository with your dotfiles and install scripts. You can use mine to help get you started. There are 3 things this is used for:

  1. The PACKAGES file: This is a simple text file containing a list of packages that should be present on your system. If they aren't present, Winbuntu will install them for you. Each package name goes on a new line. The file also supports comments:
# This is a comment in the PACKAGES file
  1. The dotfiles Directory: Any files located in this directory will be copied to your home directory. This makes importing and keeping your dotfiles up to date easy.

  2. The scripts Directory: Any scripts located in this directory will be ran by Winbuntu. This is useful for setting up more complicated things. For example, I have a script to install Oh-My-ZSH.

It's also worth noting that Winbuntu will copy your dotfile before running scripts. This means you can have scripts to do fancy things with your dotfiles, if you so desire.

environment.sh Settings

The environment.sh file contians the following structure towards the top of the file:

#####
# The environment configuration
#####
typeset -A config # init array
config=( # set default values in config array
    [gitRepo]="https://github.com/serialphotog/winbuntu-config.git"
    [workingDir]="/tmp/winbuntu/"
    [guiCommand]="i3"
)

You will want to configure these settings to match your needs. The settings are:

  • gitRepo The git repository containing your PACKAGES file, scripts, and dotfiles
  • workingDir You probably won't need to change this, but this is where Winbuntu clones your git repository to
  • guiCommand This is the command Winbuntu uses to start the Linux GUI on our X server.

Changes in Beta-1.0

The Beta-1.0 release of Winbuntu makes quite a few chagnes.

  • We now use Xming instead of a Cygwin install. This is a much more streamlined approach, which takes up quite a bit less space on disk.
  • We now use a new installer, which does the work of installing Xming and the Winbuntu system for you.
  • We now have a fix for dbus. Launching your Winbuntu environment will automatically apply the fix for you. This allows us to run a lot more apps, including some larger desktop environments (XFCE is confirmed to run)
  • Winbuntu is officially liscensed under the GPL V2
  • The old Winbuntu Cygwin Installer has been deprecated.