{"id":24444503,"url":"https://github.com/vaughnvalle/blue-sky","last_synced_at":"2025-04-05T21:09:56.814Z","repository":{"id":46191720,"uuid":"279225532","full_name":"VaughnValle/blue-sky","owner":"VaughnValle","description":"A clean and blue BSPWM setup","archived":false,"fork":false,"pushed_at":"2024-06-13T04:35:52.000Z","size":12718,"stargazers_count":354,"open_issues_count":2,"forks_count":31,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-29T20:07:21.341Z","etag":null,"topics":["blue","bspwm","linux","polybar","rice","ricing","rofi","slimlock","unixporn"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VaughnValle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-13T06:05:23.000Z","updated_at":"2025-03-18T14:51:58.000Z","dependencies_parsed_at":"2024-01-14T15:24:42.110Z","dependency_job_id":"5b69d3bc-17ea-4951-a1f2-9451bbff5ee8","html_url":"https://github.com/VaughnValle/blue-sky","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VaughnValle%2Fblue-sky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VaughnValle%2Fblue-sky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VaughnValle%2Fblue-sky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VaughnValle%2Fblue-sky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VaughnValle","download_url":"https://codeload.github.com/VaughnValle/blue-sky/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399885,"owners_count":20932880,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blue","bspwm","linux","polybar","rice","ricing","rofi","slimlock","unixporn"],"created_at":"2025-01-20T22:52:10.364Z","updated_at":"2025-04-05T21:09:56.781Z","avatar_url":"https://github.com/VaughnValle.png","language":"C","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=8QCEHJMN43VAE","https://www.patreon.com/sudo_rice"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eCerulean\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/MAINTAINED-YES-green?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-blue?style=for-the-badge\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/VaughnValle/blue-sky?style=for-the-badge\"\n\u003c/p\u003e\n\n[![Cerulean - 50 Shades of Blue](https://raw.githubusercontent.com/VaughnValle/mirth-os/master/images/cerulean.gif)](https://www.youtube.com/watch?v=Le_gTAlBNO8)\n\nCerulean is a minimalistic Linux setup for Pop! OS using various shades of blue. This setup uses BSPWM as the tiling window manager.\n\nLove the content? Help me reach my goal of upgrading my laptop integrated GPU; any amount helps :)\n\n[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=8QCEHJMN43VAE)\n\nOr consider supporting me __on these platforms:__  \n\n[![](https://c5.patreon.com/external/logo/become_a_patron_button.png)](https://www.patreon.com/sudo_rice)\n[![](https://raw.githubusercontent.com/VaughnValle/demo/master/yt-badge.png)](https://www.youtube.com/sudo_rice)\n\n\n## Dependencies\n* bspwm\n* sxhkd\n* polybar\n* picom\n* rofi\n* spotify-client\n* spicetify\n* alacritty\n* zsh\n* oh my zsh!\n* powerlevel10k\n* vim\n* slim\n* slimlock\n\n## Installation Steps (Ubuntu/Pop! OS 20.04)\n__NOTE:__ This guide uses ``~/Downloads`` as the default path for cloning repos\n1. Update your repositories:\n\n\t\t sudo apt update\n2. Upgrade your system:\n\n\t\t sudo apt upgrade\n3. Install __bspwm__:\n\n\tInstall required dependencies (vim included):\n\n\t\t sudo apt install build-essential git vim xcb libxcb-util0-dev libxcb-ewmh-dev libxcb-randr0-dev libxcb-icccm4-dev libxcb-keysyms1-dev libxcb-xinerama0-dev libasound2-dev libxcb-xtest0-dev libxcb-shape0-dev libuv1-dev\n\tClone the repository:\n\n\t\t cd ~/Downloads\n\t\t git clone https://github.com/baskerville/bspwm.git\n\tCompile and install bspwm:\n\t\t\t \n\t\t cd bspwm\n\t\t make\n\t\t sudo make install\n\tCopy bspwm configuration files:\n\t\t\t \n\t\t mkdir ~/.config/bspwm\n\t\t cp examples/bspwmrc ~/.config/bspwm\n\t\t chmod +x ~/.config/bspwm/bspwmrc\n\t\t cd ..\n\t__OPTIONAL:__ Configure bspwmrc to your liking\n\n\t\t vim ~/.config/bspwm/bspwmrc\n\n4. Install __sxhkd__:\n\t\n\tClone the repository:\n\n\t\t git clone https://github.com/baskerville/sxhkd.git\n\tCompile and install sxhkd:\n\t\t\t \n\t\t cd sxhkd\n\t\t make\n\t\t sudo make install\n\tCopy sxhkd configuration files:\n\t\t\t\n\t\t mkdir ~/.config/sxhkd\n\t\t cp ../bspwm/examples/sxhkdrc ~/.config/sxhkd\n\t\t cd ..\n\t__OPTIONAL:__ Configure the keybind in sxhkdrc to your liking:\n\n\t\t vim ~/.config/sxhkd/sxhkdrc\n\t\n\t---  \n\t __NOTE:__ Make sure the terminal emulator used in the config file is installed as the terminal will be the only way we can interact with bspwm upon startup after a fresh installation\n\n\t---\n5. Install Polybar:\n\t\n\tInstall required dependencies:\n\n\t\t sudo apt install cmake cmake-data pkg-config python3-sphinx libcairo2-dev libxcb1-dev libxcb-util0-dev libxcb-randr0-dev libxcb-composite0-dev python3-xcbgen xcb-proto libxcb-image0-dev libxcb-ewmh-dev libxcb-icccm4-dev libxcb-xkb-dev libxcb-xrm-dev libxcb-cursor-dev libasound2-dev libpulse-dev libjsoncpp-dev libmpdclient-dev libcurl4-openssl-dev libnl-genl-3-dev\n\tClone the repository:\n\t\n\t\t git clone --recursive https://github.com/polybar/polybar\n\tCompile and install __Polybar__:\n\n\t\t cd polybar\n\t\t mkdir build\n\t\t cd build\n\t\t cmake ..\n\t\t make -j$(nproc)\n\t\t sudo make install\n6. Install Picom:\n\t\n\tInstall required dependencies:\n\n\t\t sudo apt install meson libxext-dev libxcb1-dev libxcb-damage0-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-render-util0-dev libxcb-render0-dev libxcb-randr0-dev libxcb-composite0-dev libxcb-image0-dev libxcb-present-dev libxcb-xinerama0-dev libpixman-1-dev libdbus-1-dev libconfig-dev libgl1-mesa-dev  libpcre2-dev  libevdev-dev uthash-dev libev-dev libx11-xcb-dev libxcb-glx0-dev\n\tClone the repository:\n\n\t\t git clone https://github.com/ibhagwan/picom.git\n\tBuild (with Ninja):\n\n\t\t cd picom\n\t\t git submodule update --init --recursive\n\t\t meson --buildtype=release . build\n\t\t ninja -C build\n\tInstall __Picom__:\n\n\t\t sudo ninja -C build install\n\t\t cd ..\n\t---  \n\t__NOTE:__ Default installation path is ``/usr/local``, use this to change the install prefix:\n\n\t\t meson configure -Dprefix=\u003cpath\u003e build\n\n\t---\n7. Install Rofi:\n\t\n\tInstall required dependencies:\n\n\t\t sudo apt install bison flex libstartup-notification0-dev check autotools-dev libpango1.0-dev librsvg2-bin librsvg2-dev libcairo2-dev libglib2.0-dev libxkbcommon-dev libxkbcommon-x11-dev libjpeg-dev\n\tGet necessary releases:\n\n\t\t cd ~/Downloads\n\t\t wget https://github.com/davatorium/rofi/releases/download/1.5.4/rofi-1.5.4.tar.gz\n\t\t wget https://github.com/libcheck/check/releases/download/0.15.1/check-0.15.1.tar.gz\n   \t\t tar -xvzf rofi-1.5.4.tar.gz\n   \t\t tar -xvzf check-0.15.1.tar.gz\n\tBuild check:\n\n\t\t cd check-0.15.1\n\t\t ./configure\n\t\t make\n\t\t make check\n\tInstall check:\n\n\t\t sudo make insttar -xvzfall\n\t\t cd ..\n\tBuild __rofi__:\n\n\t\t cd rofi\n\t\t mkdir build \u0026\u0026 cd build\n\t\t ../configure\n\t\t make\n\tInstall __rofi__:\n\n\t\t sudo make install\n\tEnable and use __rofi__:\n\n\t\t vim ~/.config/sxhkd/sxhkdrc\n\t  \n\tChange __dmenu__ to:\n\n\t\t rofi -modi run,drun,window -show drun -show-icons -sidebar-mode \n9. Install spotify:\n\n\t\t curl -sS https://download.spotify.com/debian/pubkey_0D811D58.gpg | sudo apt-key add - \n\t\t echo \"deb http://repository.spotify.com stable non-free\" | sudo tee /etc/apt/sources.list.d/spotify.list\n\t\t sudo apt update \u0026\u0026 sudo apt install spotify-client\n10. Install spicetify:\n\n\tInstall __spicetify__:\n\n\t\t curl -fsSL https://raw.githubusercontent.com/khanhas/spicetify-cli/master/install.sh | sh\n\t\t sudo chmod a+wr /usr/share/spotify\n\t \t sudo chmod a+wr /usr/share/spotify/Apps -R\n\tLaunch Spotify using spicetify: \n\n\t\t spicetify\n\t\t spicetify backup apply enable-devtool\n\t\t spicetify update\n\tTheming:\n\n\t\t cd ~/Downloads\n\t\t git clone https://github.com/morpheusthewhite/spicetify-themes.git\n\t \t cd spicetify-themes\n\t \t cp -r * ~/spicetify-cli/Themes\n\t \t cd ~/spicetify-cli/Themes/Dribbblish/\n\t \t cp dribbblish.js ../../Extensions\n\t \t spicetify config extensions dribbblish.js\n\t\t spicetify config current_theme Dribbblish color_scheme nord-dark\n\t \t spicetify config inject_css 1 replace_colors 1 overwrite_assets 1\n\t \t spicetify apply\n11. Install alacritty: \n\t\n\tInstall __alacritty__:\n\n\t\t sudo apt install alacritty\n\tClone the repo: \n\n\t\t cd ~/Downloads\n\t\t git clone https://github.com/VaughnValle/blue-sky.git\n\tApply alacritty theme:\n\n\t\t mkdir ~/.config/alacritty\n\t\t cp blue-sky/alacritty/alacritty.yml ~/.config/alacritty/\n\t---\n\t__NOTE:__ If you get the ```error: GLSL 3.30 is not supported``` error, do this:\n\n\t\t vim /usr/share/applications/com.alacritty.Alacritty.desktop\n          \n\tand change ``Exec=alacritty`` to ``Exec=bash -c \"LIBGL_ALWAYS_SOFTWARE=1 alacritty\"``\n\n\t---\n12. Apply the desktop wallpaper:\n\n\t\t sudo apt install feh\n\t\t echo 'feh --bg-fill $HOME/Downloads/blue-sky/wallpapers/blue3.png' \u003e\u003e ~/.config/bspwm/bspwmrc\n13. Configure polybar:\n\n\t\t mkdir ~/.config/polybar\n\t\t cd ~/Downloads/blue-sky/polybar\n\t\t cp * -r ~/.config/polybar\n\t\t echo '~/.config/polybar/./launch.sh' \u003e\u003e ~/.config/bspwm/bspwmrc\n\t\t cd fonts\n\t\t sudo cp * /usr/share/fonts/truetype/\n14. Install Oh My ZSH!:\n\n\t\t sudo apt install zsh\n\t\t sh -c \"$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\n15. Install Powerlevel10k:\n\n\t\t git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k\n16. Theme vim:\n\n\t\t mkdir -p ~/.vim/colors\n\t\t cd ~/Downloads\n\t\t cp blue-sky/nord.vim ~/.vim/colors\n\t\t git clone https://github.com/vim-airline/vim-airline.git\n\t\t cd vim-airline\n\t\t cp * -r ~/.vim\n\t\t cd ~/Downloads\n\t\t git clone https://github.com/vim-airline/vim-airline-themes.git\n\t\t cd vim-airline-themes\n\t\t cp * -r ~/.vim\n\t\t echo 'colorscheme nord' \u003e\u003e ~/.vimrc\n\t\t echo let g:airline_theme=\\'base16\\' \u003e\u003e ~/.vimrc\n17. Theme rofi:\n\n\t\t mkdir -p ~/.config/rofi/themes\n\t\t cp ~/Downloads/blue-sky/nord.rasi ~/.config/rofi/themes\n\t\t rofi-theme-selector #preview the \"nord theme\" with Enter and apply it with Alt+a\n\t\t \n\t\t # modify keybindings\n\t\t vim ~/.config/sxhkd/sxhkdrc\n\t\t # replace dmenu with rofi -show drun\n18. Install slim and slimlock:\n\n\tInstallation __slim__ and __slimlock__:\n\t\n\t\t sudo apt install slim libpam0g-dev libxrandr-dev libfreetype6-dev libimlib2-dev libxft-dev\n\t\t sudo dpkg-reconfigure gdm3 #select slim\n\t\t \n\t---\n\t__NOTE:__ If you get ``fatal error: ft2build.h:`` do:\n\n\t\t sudo vim /usr/include/X11/Xft/Xft.h\n\t\n\tChange line __39__: to ``#include \u003cfreetype2/ft2build.h\u003e\" \u003ctruncated\u003e`` and do:\n\n\t\t sudo cp /usr/include/freetype2/freetype /usr/include\n\n\tThen run:\n\t\t\n\t\t sudo make\n\t\t sudo make install\n\t\t cd ..\n\t---\t\n\tTheming:\n\n\t\t cd ~/Downloads/blue-sky\n\t\t sudo cp slim.conf /etc \u0026\u0026 sudo cp slimlock.conf /etc\n\t\t sudo cp default /usr/share/slim/themes\n\n## Thanks for dropping by!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaughnvalle%2Fblue-sky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaughnvalle%2Fblue-sky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaughnvalle%2Fblue-sky/lists"}