js0ny/dotfiles
1
0
Fork 0
mirror of https://github.com/js0ny/dotfiles.git synced 2025-12-21 08:43:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
dotfiles/platforms/win
History
js0ny 5af44bfa90 chore(glzr): Add rules
2025-03-13 07:03:30 +00:00
..
ahk feat(bootstrap): Initialise windows script 2025-03-03 11:45:32 +00:00
cmd sync: from Windows 2024-12-19 20:08:33 +00:00
glzr chore(glzr): Add rules 2025-03-13 07:03:30 +00:00
komorebi Merge branch 'master' into reorg 2024-12-01 07:41:57 +00:00
start feat(bootstrap): Initialise windows script 2025-03-03 11:45:32 +00:00
fastfetch.jsonc minor fix 2025-03-05 01:35:56 +00:00
Microsoft.PowerShell_profile.ps1 docs: Add documentational comments 2025-01-28 14:24:30 +00:00
neovide.toml minor fix 2025-03-03 22:39:24 +00:00
readme.md sync from windows 2025-01-07 22:12:18 +00:00
SumatraPDF-shortcuts.txt sync: from Windows 2024-12-05 2024-12-05 20:08:57 +00:00
vsvimrc Merge branch 'master' into reorg 2024-12-01 07:41:57 +00:00
WindowsTerminal.json refractor: Reorganise dotfiles structures 2024-11-29 23:28:18 +00:00
wslconfig sync: from Windows 2024-12-19 20:08:33 +00:00
wslgconfig feat(emacs) rime 2025-02-10 04:26:16 +00:00

readme.md

Windows dotfiles

Windows

By following the Windows Directory Standard, assign the following directories corresponding to $XDG_CONFIG in Unix, some of the software(like wezterm) will use these directories as the default configuration path:

Windows Path XDG-Equivalent Default
%APPDATA% $XDG_CONFIG_HOME %USERPROFILE%\AppData\Roaming
%LOCALAPPDATA% $XDG_DATA_HOME %USERPROFILE%\AppData\Local
%LOCALAPPDATA%\Cache $XDG_CACHE_HOME %USERPROFILE%\AppData\Local\Cache
%LOCALAPPDATA%\State $XDG_STATE_HOME %USERPROFILE%\AppData\Local\State

An example bootstrap script is provided in bootstrap/Windows.ps1, which will create necessary directories and link the files.

PowerShell Profile

This is the PowerShell Core profile, not the legacy Windows PowerShell profile, which is faster(powershell vs pwsh, pwsh types 6 letters less lol), cross-platform and compatible with Unix.

By default, PowerShell profile is stored in %UserProfile%\Documents\PowerShell\Microsoft.PowerShell_profile.ps1.

It is convenient to use $PROFILE to locate the profile file.

Test-Path $PROFILE

Just like Unix Shell, there are configs work for different sessions. To locate them, use select * followed by $PROFILE.

If you want to change the AllUsers scoped profile, do not install pwsh via winget, use scoop instead, since winget will install pwsh to %ProgramFiles%\PowerShell\7\pwsh.exe, which is read-only even with Administrator privileges.

PS > $PROFILE | Select *
AllUsersAllHosts       : C:\Users\jsony\scoop\apps\pwsh\current\profile.ps1
AllUsersCurrentHost    : C:\Users\jsony\scoop\apps\pwsh\current\Microsoft.PowerShell_profile.ps1
CurrentUserAllHosts    : C:\Users\jsony\Documents\PowerShell\profile.ps1
CurrentUserCurrentHost : C:\Users\jsony\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
Length                 : 68

Note that the variable $PROFILE.* are constants, the only way to change it is to compile your own pwsh

To link the profile file:

New-Item -ItemType SymbolicLink -Path $PROFILE -Target "$DOTFILES\win\Microsoft.PowerShell_profile.ps1" -Force

I use starship to customize the prompt, which is located in tools/starship/starship_pwsh.toml. This prompt config is cross-platform for powershell core, since I use the prompt to identify the shell.

.wslconfig - WSL2 Configuration

.wslconfig only supports %UserProfile%\.wslconfig as the configuration path

New-Item -ItemType SymbolicLink -Path "$Env:UserProfile\.wslconfig" -Target "$DOTFILES\win\.wslconfig" -Force

Neovide

Neovide configuration is (only) stored in %APPDATA%\neovide\config.toml

New-Item -ItemType SymbolicLink -Path "$Env:AppData\neovide\config.toml" -Target "$DOTFILES\win\neovide.toml" -Force