{"id":30815128,"url":"https://github.com/devleonardoamaral/debian-nvidia-installer","last_synced_at":"2025-09-06T08:08:16.279Z","repository":{"id":308071464,"uuid":"1031520688","full_name":"devleonardoamaral/debian-nvidia-installer","owner":"devleonardoamaral","description":"NVIDIA driver installer with a Bash TUI. This tool allows you to install NVIDIA drivers on Debian Trixie using an interactive text-based interface (TUI). It automates steps such as package installation, compatibility checks, and graphics environment configuration.","archived":false,"fork":false,"pushed_at":"2025-09-06T01:47:04.000Z","size":678,"stargazers_count":38,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-06T02:40:20.658Z","etag":null,"topics":["debian","drivers","linux","nvidia","trixie"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devleonardoamaral.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"devleonardoamaral"}},"created_at":"2025-08-03T23:09:07.000Z","updated_at":"2025-09-06T01:47:09.000Z","dependencies_parsed_at":"2025-08-06T15:09:24.436Z","dependency_job_id":"a6acb5e5-48e4-4662-9210-d13aec38386a","html_url":"https://github.com/devleonardoamaral/debian-nvidia-installer","commit_stats":null,"previous_names":["devleonardoamaral/debian-nvidia-install","devleonardoamaral/debian-nvidia-installer"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/devleonardoamaral/debian-nvidia-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devleonardoamaral%2Fdebian-nvidia-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devleonardoamaral%2Fdebian-nvidia-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devleonardoamaral%2Fdebian-nvidia-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devleonardoamaral%2Fdebian-nvidia-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devleonardoamaral","download_url":"https://codeload.github.com/devleonardoamaral/debian-nvidia-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devleonardoamaral%2Fdebian-nvidia-installer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273874160,"owners_count":25183368,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["debian","drivers","linux","nvidia","trixie"],"created_at":"2025-09-06T08:05:15.943Z","updated_at":"2025-09-06T08:08:16.267Z","avatar_url":"https://github.com/devleonardoamaral.png","language":"Shell","funding_links":["https://github.com/sponsors/devleonardoamaral"],"categories":[],"sub_categories":[],"readme":"# debian-nvidia-installer\n\nNVIDIA driver installer with a Bash TUI. This tool allows you to install NVIDIA drivers on Debian using an interactive text-based interface (TUI).\nIt automates steps such as package installation, compatibility checks, and graphics environment configuration.\n\n\u003cimg src=\"data/screenshots/main-menu.png\"\u003e\n\n\u003cdiv style=\"display:flex; gap:10px;\"\u003e\n  \u003cimg src=\"data/screenshots/drivers-menu.png\" width=\"270\" height=\"183\"\u003e\n  \u003cimg src=\"data/screenshots/post-installation-menu.png\" width=\"270\" height=\"183\"\u003e\n  \u003cimg src=\"data/screenshots/app-gpu-preferences-menu.png\" width=\"270\" height=\"183\"\u003e\n\u003c/div\u003e\n\n### Requirements\n\n* Debian Trixie distribution\n* amd64 architecture\n* Compatible NVIDIA graphics card\n  \u003e Official NVIDIA drivers on Debian Trixie do not support [GPUs based on the Fermi or Kepler architecture](https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/).\n\n  \u003e See [Debian’s guide on installing legacy drivers](https://wiki.debian.org/NvidiaGraphicsDrivers#Tesla_Drivers) if needed.\n* Bash-compatible shell\n* Administrator privileges (sudo/root)\n\n# How to Run\n\nAfter installation, you can start the script through the shortcut in the applications menu or via the terminal by running the command:\n\n```bash\nsudo debian-nvidia-installer\n```\n\u003e ⚠️ **It is necessary to run as root**, as the tool makes system changes such as installing packages and modifying configuration files.\n\n# Installation\n\nYou can install `debian-nvidia-installer` by downloading the `.deb` package from the **[Releases](https://github.com/devleonardoamaral/debian-nvidia-installer/releases)** section of this repository.\n\n### Option 1: Graphical Interface\n\n1. Download the `.deb` package.\n2. **Double-click** the file to open it with your system's package manager.\n3. Click **“Install”**. You may be prompted to enter your administrator password.\n\n\u003e 💡 Compatible with package managers such as GDebi, Discover (KDE), GNOME Software, and similar tools.\n\n### Option 2: Terminal\n\nBefore starting, check the version of the `.deb` package you downloaded from GitHub. Replace `X.X.X` in the commands below with the correct version.\nFor example, if the version is `0.0.1`, the file will be `debian-nvidia-installer_0.0.1_amd64.deb`.\n\nCopy the `.deb` file to the `/tmp` directory to avoid permission issues with the system package manager:\n\n```bash\ncp ./debian-nvidia-installer_X.X.X_amd64.deb /tmp/\n```\n\n\u003e 💡 Files in the `/tmp` directory are automatically removed after a system reboot.\n\nChange to the temporary directory `/tmp`, where the `.deb` file was moved:\n\n```bash\ncd /tmp\n```\n\nInstall the package using `apt` so that the script dependencies are installed correctly:\n\n```bash\nsudo apt install ./debian-nvidia-installer_X.X.X_amd64.deb\n```\n\n\u003e ⚠️ **Important:** Do not install using `dpkg -i`, as this will not resolve the package dependencies and the package may break.\n\n### Option 3: Build and install manually (for advanced users)\n\nClone the repository locally on your computer using [git](https://packages.debian.org/stable/git):\n\n```bash\ngit clone https://github.com/devleonardoamaral/debian-nvidia-installer.git\n```\n\nChange to the cloned repository directory:\n\n```bash\ncd debian-nvidia-installer\n```\n\nRun the build script provided in the repository. It will create the `.deb` package in `./deb_build/debian-nvidia-installer_X.X.X_amd64.deb`:\n\n```bash\n./build_deb.sh\n```\n\nTo install the `.deb` package, follow the same steps as in [Option 1: Graphical Interface](#option-1-graphical-interface) or [Option 2: Terminal](#option-2-terminal).\n\n# Uninstallation\n\nTo completely remove the script and its dependencies, run the following command:\n\n```bash\nsudo apt purge --autoremove debian-nvidia-installer\n```\n\n---\n\nPara a versão em **Português do Brasil**, veja [README.pt_BR.md](README.pt_BR.md)\n\n---\n.\n\u003e Hello, Debians!\n\u003e\n\u003e I created this script because I genuinely wanted to contribute to the Linux community, especially to Debian users. I know that moving to Debian can be challenging, particularly for those with NVIDIA hardware, and setting up the drivers correctly is often confusing and intimidating. My goal was to make this process simpler, more accessible, and less stressful for anyone going through it.\n\u003e\n\u003e Working on this script was also a personal journey for me. It was an opportunity to dive deeper into Linux, understand how the system works under the hood, and explore Bash in a practical way. Sharing the project on GitHub felt like a natural step—not only so others can use it, but also so anyone interested can learn, suggest improvements, and contribute. I hope it helps users, encourages collaboration, and strengthens knowledge sharing within the community.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevleonardoamaral%2Fdebian-nvidia-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevleonardoamaral%2Fdebian-nvidia-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevleonardoamaral%2Fdebian-nvidia-installer/lists"}