Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/serialphotog/winbuntu
Makes creating and managing a Linux environment through the Windows 10 WSL easy
https://github.com/serialphotog/winbuntu
linux linux-environment winbuntu winbuntu-installer wsl
Last synced: about 1 month ago
JSON representation
Makes creating and managing a Linux environment through the Windows 10 WSL easy
- Host: GitHub
- URL: https://github.com/serialphotog/winbuntu
- Owner: serialphotog
- License: gpl-2.0
- Archived: true
- Created: 2016-07-05T17:51:14.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-04-22T01:22:02.000Z (over 7 years ago)
- Last Synced: 2024-07-23T14:03:32.535Z (about 2 months ago)
- Topics: linux, linux-environment, winbuntu, winbuntu-installer, wsl
- Language: Shell
- Homepage:
- Size: 17.6 KB
- Stars: 77
- Watchers: 10
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- jimsghstars - serialphotog/winbuntu - Makes creating and managing a Linux environment through the Windows 10 WSL easy (Shell)
README
# 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](http://www.howtogeek.com/249966/how-to-install-and-use-the-linux-bash-shell-on-windows-10/). 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](https://github.com/serialphotog/winbuntu/releases/tag/1.0.0). 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](https://github.com/serialphotog/winbuntu-config) 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
```
2. **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.
3. **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](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
* The old Winbuntu Cygwin Installer has been deprecated.