Welcome to the official v38armageddon's Docs!

Here you can find all the documentations for any projects made by v38armageddon.

Presentation

Welcome to the Vincent OS Documentation, you can find several information about Vincent OS and its different features.

Vincent OS is a Operating System based on Arch, it was created by v38armageddon.

The principal features are:

• Unique desktop layout with KDE.
• Dedicated repository.
• PowerShell by default.
• Windows compatibility with Wine.
• Core LivePatch, a hotpatch manager to apply critical updates without rebooting.
• ClamAV integration for enhanced security.
• linux-zen as the default kernel for improved performance.

You can find in this documentation all the information you need to get started with Vincent OS and technical details about its features.

For any questions or feedback, you can reach out the Community on the Vincent OS Forum.

System Requirements

Vincent OS requires the following minimum system specifications for installation:

Download the ISO

The Vincent OS ISO can be downloaded from the official website via Internet Archive.

In this page you can find all releases versions of Vincent OS as well as their states.

Supported versions

Discontinued versions

Flash the ISO

Classic Method

After downloading the ISO, you need:

• A external device for the ISO
• Rufus (if you are on Windows)
• Enough storage space for Vincent OS
• Backup all your personal data in a external device and/or a cloud!

If you are on Windows:
Download Rufus and launch from your system, chose the peripheral of your external device and select the Vincent OS ISO by clicking on the button: SELECTION, after, click on: START. Select the ISO method and wait.

If you are on Linux:
You can use GNOME Disk for flashing the ISO in your external device. It's the safest and recommended method if you don't want be risky. On GNOME Disk, select your device, click on hamburger button and select: Restore disk image. Select the Vincent OS ISO and wait (you need to enter your password before GNOME Disk start).

After flashing your device, reboot your computer and boot on the device. Check the manual on your motherboard how to change the boot order.

Ventoy Method

You can drag and drop the Vincent OS ISO into your Ventoy USB Stick, make sure you have the latest version of Ventoy to avoid problems.

Installation

The installation of Vincent OS is a simple process that can be completed in a few steps. Follow the instructions below to get started:

Step 1: Prepare Installation Media

To install Vincent OS, you will need to create a Vincent OS LiveCD, you can refer to the following documentation:

• Flash the ISO

Step 2: Boot from LiveCD

Change Boot Order

Once you have created the LiveCD, insert it into your computer and reboot.

You may need to change the boot order in your BIOS/UEFI settings to boot from the USB Stick first.

Boot from LiveCD

When the system starts, you should see the Vincent OS boot menu. Select the following option: Vincent OS LiveCD.

If you saw the login desktop, you have successfully booted into the LiveCD environment!

The default login credentials are as follows:

• Username: user
• Password: VincentOS

You are now logged into the Vincent OS LiveCD environment. From here, you can begin the installation process.

Installation Steps

You are now ready to begin the installation process. Follow the steps below to install Vincent OS on your system:

Step 1: Start the Installer

From the desktop environment, go to the start menu and go to the following location:
System -> Install System

Step 2: Follow the Installer Instructions

Welcome Screen

This is the welcome screen for the Vincent OS Installer, it will check if your system meets the minimum requirements for the installation.

You can select your language from the dropdown menu and click "Next" to proceed.

License & Release Notes

Before proceeding with the installation, you must accept the following licenses

• Vincent OS European Union Public License (EUPL) 1.2
• Vincent OS GNU General Public License (GPL) 3
• v38armageddon Privacy Policy

After accepting the licenses, you can find the latest Release Notes on the installer, it indicates all the new features and improvements in the new version of Vincent OS.

Location & Keyboard

In this step, you will configure your location and keyboard settings.

Partitions

You will need to choose where Vincent OS will be installed, you may encounter two views depending on your configuration:

1. New Installation without any existing partitions or installed Operating Systems
   
2. Existing Installation or other operating systems
   

Here is a explanation of the different options:

• [Existing installation only] Install alongside: This option will install Vincent OS alongside with an existing operating system, allowing you to choose which OS to boot at startup.

• [Existing installation only] Replace a partition: This option will replace an existing partition with Vincent OS, erasing all data on the selected partition. This option is useful when you want to quickly reinstall Vincent OS without having to erase all data on the disk.

• Erase disk: This option will erase the entire disk and install Vincent OS. This is the recommended option for a full clean installation.

• Manual partitioning: This option is for advanced users who want to create, delete, or modify partitions manually. This gives you full control over the partitioning scheme but requires a good understanding of disk partitioning.

Users

In this step, you will create your user account. You will need to provide the following information:

• Username (must be in lowercase, not containing spaces)
• Full name
• Computer name (generated in the following format: <username>-<your pc motherboard>-vincentOS)
• Password

Summary & Install

This will recapitulate all the choices you made during the installation process. Review the summary carefully and click "Install" to begin the installation of Vincent OS. A message will appear to confirm a last time your installation.

The installation process will begin, and you will see a progress bar indicating the status of the installation. This may take some time.

Finish

Once the installation is complete, you will see a message indicating that Vincent OS has been successfully installed. You can then reboot your system and start using Vincent OS!

Post Installation Tips

Congratulations! You have successfully installed Vincent OS and are now ready to explore its features! To avoid getting lost in this new operating system, follow these tips.

Desktop Environment

You can see that the desktop environment is different from what you may be used to. Take some time to explore the new layout and features. Here are a few key points to help you navigate:

Top bar

The top bar contains three icons, on the left you will have the date and time click here and you have the calendar.

In the center you have the list of the notifications you have missed and on the right, you have the user menu.
The user menu allows you to switch between different user accounts and access to system shutdown options.

Bottom bar

The bottom bar contains three elements: the start menu on the left, allowing you to access your applications, the taskbar in the center, showing your open applications, and the system tray on the right, displaying quick settings.

Discover (Software Center)

The Discover Software is the software store for Vincent OS, allowing you to easily find, install, and manage installed software.

If you are more of a technical user, you can also use the command line to install software packages with pacman.

Updates

When you have a fresh install of Vincent OS, some packages may be outdated. To ensure you have the latest software and security updates, it's a good idea to run the following commands:

Update-System.ps1

This script will update your system and install any available updates.

Core LivePatch

Vincent OS includes a unique feature called Core LivePatch, allows you to update critical system components without rebooting your machine.

To get more technical details about how Core LivePatch works and how to use it, please refer to the Core LivePatch documentation.

Core LivePatch

Definition

Core LivePatch (abbreviated to CLP) allows you to update critical Vincent OS part via patches without rebooting your computer.

Features

Core LivePatch can do the following tasks:

• Applying critical patches: Update key system files, such as configuration files in /etc, to address urgent issues.
• Revert a previous version of a specific package: Roll back a specific package version to resolve critical issues (e.g. Revert a previous version for the following issue: nvidia-black-screen-after-an-update.md).

All patches are distributed in a .clp format, designed specifically for Vincent OS.

Comparison with other live patching solutions

This is a list of live partching solutions and their key differences:

Source code of Core LivePatch can be found in the Vincent OS GitHub repository.

NVIDIA: Black screen after an update

In case of a NVIDIA driver update and after reboot, you only see a black screen, follow this guide to how downgrade the NVIDIA driver.

1. Open a Terminal
2. Go to /var/cache/pacman/pkg by typing the following command:

PS> Set-Location /var/cache/pacman/pkg

3. Now, lookup the correct package to downgrade, there are 3 to view:

• nvidia-dkms
• nvidia-utils
• nvidia-settings

You can search the version to downgrade by going on the following websites:

• GitLab website for the NVIDIA Utils package

4. Now that you located the version, type the following command:

# pacman -U nvidia-dkms.123-4 nvidia-utils.123-4 nvidia-settings.123-4

5. Reboot the system when finished.

Congratulation you downgraded the NVIDIA Drivers!

SysRq Method

If your system become unresponcive, you can use SysRq to perform kernel level actions to troubleshoot your system.

Activation

By default, all versions of Vincent OS have SysRq enabled. You can verify if SysRq is activated by opening a terminal and enter this command:

Vincent OS Standard Edition:

PS> Get-Content /proc/sys/kernel/sysrq

If there is other values returned than 1, enable the SysRq via the command:

# sysctl kernel.sysrq=1

REISUB Method

You can reboot your system using the REISUB Method, here's how to do it:

More informations can be found on ArchLinux wiki and Wikipedia:

• ArchLinux Wiki Keyboard Shortcut
• Wikipedia Magic SysRq key

WebSM

Welcome to WebSM! Our minimalist web browser offers simplicity and ease of use. Explore our documentation to learn more about how WebSM works.

WebSM Versions

WebSM on Windows

WebSM on Windows is the first version available on the Microsoft Store.

Functionality

• Microsoft WebView2: WebSM for Windows is based on Microsoft WebView2 which is based on Microsoft Edge.
• Minimalist: WebSM for Windows is designed to be minimalist and simple for the users, only the basic search here, no more no less.
• Sidebar: A Sidebar for quick search or even, listening to music.

System Requirements for Windows

• Operating System: Windows 10 version 19041.0 or higher
• Architecture: x64
• RAM: 1 gigabyte (GB) minimum, 2 GB recommended
• Hard Disk Space: At least 32.4 MB of available disk space

Sidebar

The sidebar is a little navigator, it is used essentially for executing websites that can be played on background (eg: Spotify).

You can also use this bar doing a quick search without opening another tabs.

MediaBrowser

Here you can find several informations about MediaBrowser.

Theses informations can be used for tutorial or even knowing the functionality of the software.

Tasks

Pictures

Music

Videos

Extras

Controls for Xbox users