Initial System Setup Shell Script Builder for Fedora Workstation
Fedora Workstation: Not Another 'Things To Do'!
Initial System Setup Shell Script Builder for Fedora Workstation
Celebrating 100+ GitHub Stars!
Thank you to our amazing community for your support and contributions! As we celebrate this milestone, I've added even more great features to make your Fedora setup experience better than ever.
Check out my Medium publication for additional tweaks and configurations beyond what NATTD provides.
Overview
This project offers a Streamlit-based web application for generating a tailored shell script to set up a new Fedora Workstation installation. The app provides an intuitive interface for choosing system configurations, applications, and customization options. It is currently open for testing and is generally suitable for production use, although minor bug fixes and code improvements are ongoing.
Latest Changes
(As of 2025-08-04)
Added NetBird to the Remote Access & Networking category. Thanks @The-Sp4rt4cus
Added Sly image editor to the Media & Graphics category with Flatpak installation option
Added NetPeek network scanner to the System Tools category with Flatpak installation option
Added Android Studio IDE to the Development Tools category with Flatpak installation option
Added Qpdf Tools to the System Tools category with Flatpak installation option
Added MPV media player to the Media & Graphics category with both DNF and Flatpak installation options
Added Wave Terminal to the Development Tools category with DNF installation option
Added Onion Share to the File Sharing & Download category with Flatpak installation option
Added Warp to the File Sharing & Download category with Flatpak installation option
Added SimpleX to the Internet & Communication category with Flatpak installation option
Updated Vivaldi, NoMachine and Tabby installation URLs to latest version
Fixed bug where selected options were getting reset when performing new searches in the sidebar (Issue #17)
Previous changes (2025-03-04)
Restructured the entire codebase into a modular architecture:
Created separate modules for UI components, script generation, and utilities
Implemented a proper state management system using Streamlit's session state
Enhanced error handling throughout the application
Added comprehensive logging for better debugging
Changed the default output mode to Verbose
Fixed minor bugs
Fixed log messages being redirected to /dev/null in quiet mode, ensuring users can see progress messages
Added option to remove Fedora Flatpak repository and replace it with Flathub repository for better compatibility and stability
This addresses ongoing drama where the Fedora Flatpak repository can cause conflicts and instability
Added option to install RustDesk, a remote desktop software
Added option to install VeraCrypt, a free and open-source encryption software
Added caching for data loading to improve application performance
Improved search functionality in the sidebar for easier navigation
Enhanced the bonus scripts handling with better error management
Fixed Zerotier installation command
Updated version specific installers for the following applications:
Vivaldi Browser
Tabby Terminal
NoMachine
Previous changes (2024-09-05)
We're grateful for the valuable feedback and suggestions from the r/Fedora community. Recent updates include:
Added a search to the sidebar for easier navigation between available options and applications
Restructured the Additional Apps section for better organization
Added a new Coding and DevOps section with tools like Docker, Podman, and VSCodium
Expanded the list of additional applications, including Pika Backup, Deja Dup, and Tabby Terminal
Introduced a Bonus Scripts section for standalone customization scripts, including File Templates and NVIDIA Drivers
Included multimedia, Intel, and AMD codecs from the RPM Fusion repository
Added virtualization tools for enhanced system capabilities
Replaced bpytop with btop for improved system monitoring
Addressed inconsistent naming conventions across the project for better coherence
Added more Flatpaks to provide a wider range of application options
Introduced VSCodium as an open-source alternative to VS Code
We're continuously working to enhance the script and welcome further suggestions from the community.
Debian Version Available
Great News for Debian Users!
If you love the Fedora version of NATTD, you'll be excited to know that there's now a Debian fork available! As we celebrate reaching 100+ stars on GitHub for the Fedora edition, I'm happy to announce that you can now enjoy the same streamlined setup experience on Debian-based systems.
Check out the Debian Things To Do project to get started with your Debian workstation setup.
Features
System Configuration: Set hostname, configure DNF, enable auto-updates, install SSH, check for firmware updates, and enable RPM Fusion repositories.
Essential Apps: Install popular command-line tools and utilities with detailed descriptions.
Additional Apps: Choose from a wide range of applications categorized by purpose:
Internet & Communication (browsers, email clients, messaging apps)
Office & Productivity
Coding & DevOps
Media & Graphics
Gaming & Emulation
System Tools
Remote Access & Networking
File Sharing & Download
Customization:
Install fonts (Windows, Google, Adobe Source)
Install themes (e.g., Tela Icon Theme)
Configure power settings
Set up development environments (Zsh, Oh My Zsh, Miniconda)
Advanced Options: Add custom shell commands to be included in the generated script.
Script Preview: View a preview of the generated script before downloading.
One-Click Download: Generate and download the customized script with a single click.
Output Mode Selection: Choose between Quiet (hide command output) and Verbose (show full output) modes.
Requirements
Python 3.7+
Streamlit
A modern web browser
Installation
Clone this repository:
bash
git clone https://github.com/k-mktr/fedora-things-to-do.git
cd fedora-things-to-do
Install the required Python packages:
bash
pip install streamlit pip --upgrade
Usage
Run the Streamlit app:
streamlit run app.py
Open your web browser and navigate to the URL provided by Streamlit (usually http://localhost:8501) or use our official public instance
Use the sidebar to select your desired configuration options.
Choose the Output Mode (Quiet or Verbose) to control the level of detail in the generated script.
(Optional) Add custom shell commands in the Advanced section.
Click the "Build Your Script" button to create your customized script.
Review the script preview and click "Download Your Script" to save it.
Follow the instructions provided after generating the script to make it executable and run it on your Fedora system.
Script Template
The template.sh file serves as the base for the generated script. It includes:
Error handling and logging functionality
User prompts for optional steps
A modular structure that allows for easy customization
Caution
The generated script will make system-wide changes. Always review the script contents before running it on your system.
Contributing
Contributions are welcome! If you'd like to see additional apps or options included, please open an issue or submit a pull request. Here are some ways you can contribute:
Suggest new applications or system configurations to include
Report bugs or issues you encounter
Enhance the user interface or add new features
License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
Acknowledgements
Fedora Project for their excellent Linux distribution
✅ Enhancing user experience with more intuitive interface options
✅ Adding Advanced Section for a custom Shell Commands
✅ Further organizing the code, improving readability
✅ Improving the Quiet Mode code logic
Adding more applications and configuration options
Implementing predefined configuration Profiles
Developing versions for other Linux distributions (e.g., Debian/Ubuntu)
Implementing a feature to save and load custom profiles
Star History
FAQ
Is this script safe to run on my Fedora system?
The script is designed to be safe, but as with any system-wide changes, it's important to review the script contents before running it. We provide a preview feature so you can see exactly what the script will do. Always ensure you understand the changes that will be made to your system.
Can I use this script on other Linux distributions?
Currently, this script is specifically designed for Fedora Workstation. While some commands might work on other distributions, we don't recommend using it on non-Fedora systems without significant modifications. We're considering developing versions for other distributions in the future.
How often is the application list updated?
We strive to keep the application list up-to-date with the latest stable versions available for Fedora. However, the exact update frequency may vary. If you notice an outdated application or would like to suggest a new one, please open an issue on our GitHub repository.
Can I modify the script after it's generated?
Absolutely! The generated script is just a starting point. You're free to modify it to better suit your needs. Just be careful to maintain proper syntax and consider the potential impacts of any changes you make.
What if I encounter an error while running the script?
The script includes error handling to log issues it encounters. If you run into problems, check the log file (default location: /var/log/fedora_things_to_do.log) for more information. If you can't resolve the issue, feel free to open an issue on our GitHub repository with the error details.
Does this script handle system updates?
Yes, the script includes options for configuring DNF (Fedora's package manager) and enabling automatic updates.
Can I run the script multiple times?
While the script is designed to be somewhat idempotent (can be run multiple times without causing issues), it's not guaranteed for all operations. It's best to run it once on a fresh Fedora installation. If you need to make changes later, it's safer to generate a new script with only the additional changes you need.
How can I contribute to this project?
We welcome contributions! You can contribute by suggesting new features, reporting bugs, improving documentation, or submitting pull requests. Check out our "Contributing" section in the README for more details.
Why not use Ansible instead of a shell script?
While Ansible is a powerful tool for configuration management, our project prioritizes simplicity and transparency for end-users. The shell script approach allows user