Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nico-castell/PopOS-Setup
A script to set up Pop!_OS in the best way possible
https://github.com/nico-castell/PopOS-Setup
bash pop-os setup-script vscode zsh
Last synced: 17 days ago
JSON representation
A script to set up Pop!_OS in the best way possible
- Host: GitHub
- URL: https://github.com/nico-castell/PopOS-Setup
- Owner: nico-castell
- License: mit
- Created: 2021-01-31T14:20:04.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-10-09T16:04:03.000Z (about 2 years ago)
- Last Synced: 2024-08-08T00:44:30.746Z (4 months ago)
- Topics: bash, pop-os, setup-script, vscode, zsh
- Language: Shell
- Homepage:
- Size: 2.38 MB
- Stars: 16
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- project-awesome - nico-castell/PopOS-Setup - A script to set up Pop!_OS in the best way possible (Shell)
README
Pop!_OS Setup
How to use
I'm assuming you have just installed [Pop!_OS](https://pop.system76.com/) successfully.
1. Clone this repo, you can do a shallow clone if you wish (by adding `--depth=1` to the following
command).
```shell
$ git clone https://github.com/nico-castell/PopOS-Setup.git
```
2. Given that the main branch is always under development, you might want to checkout the last tag,
which will be the last known stable version.
```shell
$ git checkout $(git describe --tags --abrev=0) # Go to the last tag
$ git checkout main # Go back to main
```
3. (Optional) Look at the instuctions in thme [gnome_apperance](scripts/gnome_appearance.sh) script,
and configure the file structure for the script to set up the GNOME appearance with your themes.
```
scripts
└── themes
├── background
│ └── image.png
├── cursor
│ └── cursor.tar.gz
├── icons
│ └── icons.tar.gz
└── theme
└── theme.tar.gz
```
4. (Optional) If you plan on building a minecraft server, you should check that the `$download_link`
and `$version` variables are up to date, they're always market as `TODO` to be easy to find.
5. Run the [popOS_setup.sh](popOS_setup.sh) script.
```shell
$ ./popOS_setup.sh
```
6. Follow the instructions from the script.
7. Wait, this script will as for further instructions as it goes about doing it's thing.
Keep in mind
- You **must** have an internet connection to run the script.
- If you choose to update the backup image, it will have to download an entire image of
[Pop!_OS](https://pop.system76.com/). So it can take very long, depending on your internet
connection.
- If you're using an older nvidia GPU not supported by the latest nvidia driver, it might be better
to download the [Pop!_OS](https://pop.system76.com/) ISO without their custom driver, and then
choose the latest driver that supports your GPU from the list the script offers. (I'm talking
from experience)
Biggest features
This project can set up some powerful features, such as:
- Advanced, stylized prompts for the **Z-Shell**:
- Powerline plugin for the **Vim** editor:
- Setting up **GnuPG** to sign **Git** commits:
- Easily expandable lists of packages for the script to work with: [packages.txt](packages.txt),
[flatpaks.txt](flatpaks.txt) and [remove.txt](remove.txt)
- Desktop entry files that you can add at your convenience.
- A [script](scripts/mc_server_builder.sh) to set up a minecraft server.
- A [script](back_me_up.sh) to back up your home directory.
- A [script](scripts/update_recovery.sh) to update your recovery partition.
Known issues
1. [*duc_noip_install*](duc_noip_install): The installer can't seem to understand symbols when
typing a password, at least on my tests, the script opens *gedit* for you to copy/paste your
password and work around the issue.
2. [*mc_server_builder*](mc_server_builder): The link to download the latest version of the server
must be manually updated for every minecraft release.
Licensing
This repository, and all contributions to this repository, are under the [MIT License](LICENSE).
This software can also install packages under different licenses, this project's license doesn't
apply to them, see each package.
> *Live long, and prosper*.
> *Spock*