https://github.com/ppejovic/dotfiles-windows
dotfiles for Windows, including Developer-minded system defaults. Built in PowerShell
https://github.com/ppejovic/dotfiles-windows
Last synced: 5 months ago
JSON representation
dotfiles for Windows, including Developer-minded system defaults. Built in PowerShell
- Host: GitHub
- URL: https://github.com/ppejovic/dotfiles-windows
- Owner: ppejovic
- License: mit
- Fork: true (jayharris/dotfiles-windows)
- Created: 2017-10-16T23:39:45.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-08-21T20:39:52.000Z (over 5 years ago)
- Last Synced: 2024-08-14T07:07:24.069Z (8 months ago)
- Language: PowerShell
- Homepage:
- Size: 194 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - ppejovic/dotfiles-windows - dotfiles for Windows, including Developer-minded system defaults. Built in PowerShell (PowerShell)
README
# Jay Harris's dotfiles for Windows
A collection of PowerShell files for Windows, including common application installation through `Chocolatey` and `npm`, and developer-minded Windows configuration defaults.
Are you a Mac user? Check out my [dotfiles](https://github.com/jayharris/dotfiles) repository.
## Installation
### Using Git and the bootstrap script
You can clone the repository wherever you want. (I like to keep it in `~\Projects\dotfiles-windows`.) The bootstrapper script will copy the files to your PowerShell Profile folder.
From PowerShell:
```posh
git clone https://github.com/jayharris/dotfiles-windows.git; cd dotfiles-windows; . .\bootstrap.ps1
```To update your settings, `cd` into your local `dotfiles-windows` repository within PowerShell and then:
```posh
. .\bootstrap.ps1
```Note: You must have your execution policy set to unrestricted (or at least in bypass) for this to work: `Set-ExecutionPolicy Unrestricted`.
### Git-free install
> **Note:** You must have your execution policy set to unrestricted (or at least in bypass) for this to work. To set this, run `Set-ExecutionPolicy Unrestricted` from a PowerShell running as Administrator.
To install these dotfiles from PowerShell without Git:
```bash
iex ((new-object net.webclient).DownloadString('https://raw.github.com/jayharris/dotfiles-windows/master/setup/install.ps1'))
```To update later on, just run that command again.
### Add custom commands without creating a new fork
If `.\extra.ps1` exists, it will be sourced along with the other files. You can use this to add a few custom commands without the need to fork this entire repository, or to add commands you don't want to commit to a public repository.
My `.\extra.ps1` looks something like this:
```posh
# Hg credentials
# Not in the repository, to prevent people from accidentally committing under my name
Set-Environment "EMAIL" "Jay Harris "# Git credentials
# Not in the repository, to prevent people from accidentally committing under my name
Set-Environment "GIT_AUTHOR_NAME" "Jay Harris","User"
Set-Environment "GIT_COMMITTER_NAME" $env:GIT_AUTHOR_NAME
git config --global user.name $env:GIT_AUTHOR_NAME
Set-Environment "GIT_AUTHOR_EMAIL" "jay@aranasoft.com"
Set-Environment "GIT_COMMITTER_EMAIL" $env:GIT_AUTHOR_EMAIL
git config --global user.email $env:GIT_AUTHOR_EMAIL
```Extras is designed to augment the existing settings and configuration. You could also use `./extra.ps1` to override settings, functions and aliases from my dotfiles repository, but it is probably better to [fork this repository](#forking-your-own-version).
### Sensible Windows defaults
When setting up a new Windows PC, you may want to set some Windows defaults and features, such as showing hidden files in Windows Explorer and installing IIS. This will also set your machine name and full user name, so you may want to modify this file before executing.
```post
.\windows.ps1
```### Install dependencies and packages
When setting up a new Windows box, you may want to install some common packages, utilities, and dependencies. These could include node.js packages via [NPM](https://www.npmjs.org), [Chocolatey](http://chocolatey.org/) packages, Windows Features and Tools via [Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx), and Visual Studio Extensions from the [Visual Studio Gallery](http://visualstudiogallery.msdn.microsoft.com/).
```posh
.\deps.ps1
```> The scripts will install Chocolatey, node.js, and WebPI if necessary.
> **Visual Studio Extensions**
> Extensions will be installed into your most current version of Visual Studio. You can also install additional plugins at any time via `Install-VSExtension $url`. The Url can be found on the gallery; it's the extension's `Download` link url.## Forking your own version
This repository is built around how I use Windows, which is predominantly in a VM hosted on OS X. As such, things like VNC, FileZilla, or Skype are not installed, as they are available to me on the OS X side, installed by my [OS X dotfiles](https://github.com/jayharris/dotfiles). If you are using Windows as your primary OS, you may want a different configuration that reflects that, and I recommend you [fork this repository](https://github.com/jayharris/dotfiles-windows/fork).
If you do fork for your own custom configuration, you will need to touch a few files to reference your own repository, instead of mine.
Within `/setup/install.ps1`, modify the Repository variables.
```posh
$account = "jayharris"
$repo = "dotfiles-windows"
$branch = "master"
```Within the Windows Defaults file, `/windows.ps1`, modify the Machine
name on the first line.
```posh
(Get-WmiObject Win32_ComputerSystem).Rename("MyMachineName") | Out-Null
```Finally, be sure to reference your own repository in the git-free installation command.
```bash
iex ((new-object net.webclient).DownloadString('https://raw.github.com/$account/$repo/$branch/setup/install.ps1'))
```## Feedback
Suggestions/improvements are
[welcome and encouraged](https://github.com/jayharris/dotfiles-windows/issues)!## Author
| [](http://twitter.com/jayharris "Follow @jayharris on Twitter") |
|---|
| [Jay Harris](http://twitter.com/jayharris/) |## Thanks to…
* @[Mathias Bynens](http://mathiasbynens.be/) for his [OS X dotfiles](http://mths.be/dotfiles), which this repository is modeled after.