{"id":13910992,"url":"https://github.com/nico-castell/PopOS-Setup","last_synced_at":"2025-07-18T10:32:10.484Z","repository":{"id":52543489,"uuid":"334672907","full_name":"nico-castell/PopOS-Setup","owner":"nico-castell","description":"A script to set up Pop!_OS in the best way possible","archived":false,"fork":false,"pushed_at":"2022-10-09T16:04:03.000Z","size":2494,"stargazers_count":16,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-25T20:39:24.830Z","etag":null,"topics":["bash","pop-os","setup-script","vscode","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/nico-castell.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-31T14:20:04.000Z","updated_at":"2024-10-06T03:16:02.000Z","dependencies_parsed_at":"2023-01-19T17:15:38.765Z","dependency_job_id":null,"html_url":"https://github.com/nico-castell/PopOS-Setup","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/nico-castell/PopOS-Setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nico-castell%2FPopOS-Setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nico-castell%2FPopOS-Setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nico-castell%2FPopOS-Setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nico-castell%2FPopOS-Setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nico-castell","download_url":"https://codeload.github.com/nico-castell/PopOS-Setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nico-castell%2FPopOS-Setup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265742363,"owners_count":23820832,"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":["bash","pop-os","setup-script","vscode","zsh"],"created_at":"2024-08-07T00:01:53.454Z","updated_at":"2025-07-18T10:32:10.135Z","avatar_url":"https://github.com/nico-castell.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\t\u003cimg src=\"assets/logo.svg\" width=\"317\" height=\"230\"\u003e\n\t\u003cbr\u003ePop!_OS Setup\u003cbr\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/nico-castell/PopOS-Setup/commits\"\u003e\u003cimg alt=\"Commits since last release\" src=\"https://img.shields.io/github/commits-since/nico-castell/PopOS-Setup/latest?label=Commits%20since%20last%20release\u0026color=informational\u0026logo=git\u0026logoColor=white\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/nico-castell/PopOS-Setup/releases\"\u003e\u003cimg alt=\"release\" src=\"https://img.shields.io/github/v/release/nico-castell/PopOS-Setup?color=informational\u0026label=Release\u0026logo=GitHub\u0026logoColor=white\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"LICENSE\" src=\"https://img.shields.io/github/license/nico-castell/PopOS-Setup?color=informational\u0026label=License\u0026logo=Open%20Source%20Initiative\u0026logoColor=white\u0026style=flat-square\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/nico-castell/PopOS-Setup\"\u003e\u003cimg alt=\"Lines of code\" src=\"https://img.shields.io/tokei/lines/github/nico-castell/PopOS-Setup?label=Lines%20of%20code\u0026color=informational\u0026logo=GNU%20bash\u0026logoColor=white\u0026style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch2 align=\"center\"\u003eHow to use\u003c/h2\u003e\n\nI'm assuming you have just installed [Pop!_OS](https://pop.system76.com/) successfully.\n\n1. Clone this repo, you can do a shallow clone if you wish (by adding `--depth=1` to the following\n\tcommand).\n\t```shell\n\t$ git clone https://github.com/nico-castell/PopOS-Setup.git\n\t```\n2. Given that the main branch is always under development, you might want to checkout the last tag,\n\twhich will be the last known stable version.\n\t```shell\n\t$ git checkout $(git describe --tags --abrev=0) # Go to the last tag\n\t$ git checkout main                             # Go back to main\n\t```\n3. (Optional) Look at the instuctions in thme [gnome_apperance](scripts/gnome_appearance.sh) script,\n\tand configure the file structure for the script to set up the GNOME appearance with your themes.\n\t```\n\tscripts\n\t└── themes\n\t    ├── background\n\t    │   └── image.png\n\t    ├── cursor\n\t    │   └── cursor.tar.gz\n\t    ├── icons\n\t    │   └── icons.tar.gz\n\t    └── theme\n\t        └── theme.tar.gz\n\t```\n4. (Optional) If you plan on building a minecraft server, you should check that the `$download_link` \n\tand `$version` variables are up to date, they're always market as `TODO` to be easy to find.\n5. Run the [popOS_setup.sh](popOS_setup.sh) script.\n\t```shell\n\t$ ./popOS_setup.sh\n\t```\n6. Follow the instructions from the script.\n7. Wait, this script will as for further instructions as it goes about doing it's thing.\n\n\u003ch2 align=\"center\"\u003eKeep in mind\u003c/h2\u003e\n\n- You **must** have an internet connection to run the script.\n- If you choose to update the backup image, it will have to download an entire image of\n\t[Pop!_OS](https://pop.system76.com/). So it can take very long, depending on your internet\n\tconnection.\n- If you're using an older nvidia GPU not supported by the latest nvidia driver, it might be better\n\tto download the [Pop!_OS](https://pop.system76.com/) ISO without their custom driver, and then\n\tchoose the latest driver that supports your GPU from the list the script offers. (I'm talking\n\tfrom experience)\n\n\u003ch2 align=\"center\"\u003eBiggest features\u003c/h2\u003e\n\nThis project can set up some powerful features, such as:\n\n- Advanced, stylized prompts for the **Z-Shell**:\n\t\u003cp align=\"center\"\u003e\u003cimg width=\"600\" height=\"315\" src=\"assets/prompts.png\"\u003e\u003c/p\u003e\n- Powerline plugin for the **Vim** editor:\n\t\u003cp align=\"center\"\u003e\u003cimg width=\"600\" height=\"390\" src=\"assets/vim-powerline.png\"\u003e\u003c/p\u003e\n- Setting up **GnuPG** to sign **Git** commits:\n\t\u003cp align=\"center\"\u003e\u003cimg width=\"600\" height=\"326\" src=\"assets/seahorse.png\"\u003e\u003c/p\u003e\n- Easily expandable lists of packages for the script to work with: [packages.txt](packages.txt),\n\t[flatpaks.txt](flatpaks.txt) and [remove.txt](remove.txt)\n- Desktop entry files that you can add at your convenience.\n- A [script](scripts/mc_server_builder.sh) to set up a minecraft server.\n- A [script](back_me_up.sh) to back up your home directory.\n- A [script](scripts/update_recovery.sh) to update your recovery partition.\n\n\u003ch2 align=\"center\"\u003eKnown issues\u003c/h2\u003e\n\n1. [*duc_noip_install*](duc_noip_install): The installer can't seem to understand symbols when\n\ttyping a password, at least on my tests, the script opens *gedit* for you to copy/paste your\n\tpassword and work around the issue.\n2. [*mc_server_builder*](mc_server_builder): The link to download the latest version of the server\n\tmust be manually updated for every minecraft release.\n\n\u003ch2 align=\"center\"\u003eLicensing\u003c/h2\u003e\n\nThis repository, and all contributions to this repository, are under the [MIT License](LICENSE).\nThis software can also install packages under different licenses, this project's license doesn't\napply to them, see each package.\n\n\u003e *Live long, and prosper*.  \n\u003e *Spock*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnico-castell%2FPopOS-Setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnico-castell%2FPopOS-Setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnico-castell%2FPopOS-Setup/lists"}