🔧 build(new): updated & translated

docs/troubleshoot/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Troubleshoot",
+  "position": 5,
+  "link": {
+    "type": "generated-index",
+    "description": "Common issues and troubleshooting steps for Snigdha OS."
+  }
+}

docs/troubleshoot/troubleshoot-display-problem-on-snigdha-os.md

@@ -0,0 +1,168 @@
+---
+sidebar_position: 2
+---
+
+# Troubleshooting Display Issues
+
+If you're facing display issues like screen resolution problems, black screens, or no display output on Snigdha OS, follow this guide to get everything back to normal. Let’s fix it step by step! 🔧
+
+
+
+### 1. **Check Display Cable and Connection 🖥️🔌**
+
+#### **Is Your Display Properly Connected?**
+- Make sure your monitor or laptop screen is properly connected to the system.
+- If using an external monitor, ensure that the display cable (HDMI, VGA, DisplayPort, etc.) is firmly connected.
+- If applicable, check if the monitor is set to the correct input (HDMI1, HDMI2, etc.).
+
+
+
+### 2. **Check for External Display Detection 📺📱**
+
+If you’re using multiple displays, your external monitor might not be recognized automatically.
+
+- Open the terminal and run:
+  ```bash
+  xrandr
+  ```
+  This will list all connected displays. If your external monitor isn't showing, you might need to force detection.
+
+- To detect the monitor manually:
+  ```bash
+  xrandr --auto
+  ```
+
+- If the external monitor is still not detected, try to restart your system or use a different cable.
+
+
+
+### 3. **Set the Correct Display Resolution 🎨💻**
+
+Sometimes, the wrong resolution can cause display issues. Use `xrandr` to set the correct resolution.
+
+- List available display modes:
+  ```bash
+  xrandr
+  ```
+
+- To change the resolution:
+  ```bash
+  xrandr --output <DISPLAY_NAME> --mode <RESOLUTION>
+  ```
+  Example:
+  ```bash
+  xrandr --output HDMI-1 --mode 1920x1080
+  ```
+
+Replace `<DISPLAY_NAME>` and `<RESOLUTION>` with your actual display name and resolution.
+
+
+
+### 4. **Check Graphics Driver 🔧🖥️**
+
+#### **Is Your Graphics Driver Installed?**
+Make sure you have the correct drivers installed for your graphics card.
+
+- For **Intel graphics**:
+  ```bash
+  sudo pacman -S xf86-video-intel
+  ```
+
+- For **NVIDIA graphics**:
+  ```bash
+  sudo pacman -S nvidia nvidia-utils
+  ```
+
+- For **AMD graphics**:
+  ```bash
+  sudo pacman -S xf86-video-amdgpu
+  ```
+
+After installing the necessary driver, restart your system:
+```bash
+sudo reboot
+```
+
+
+
+### 5. **Reconfigure Xorg 🎨🛠️**
+
+Sometimes, Xorg (the display server) configuration might cause issues.
+
+- Reconfigure Xorg by regenerating the configuration file:
+  ```bash
+  sudo Xorg -configure
+  ```
+
+- Then restart the system:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### 6. **Check Logs for Errors 📝🔍**
+
+Check the system logs to find any errors related to the display.
+
+- View Xorg logs:
+  ```bash
+  cat /var/log/Xorg.0.log
+  ```
+
+Look for error messages related to your graphics driver or display hardware.
+
+
+
+### 7. **Check Display Manager 🌐⚙️**
+
+If you’re getting a black screen after logging in, it could be a problem with your display manager.
+
+- If using **LightDM**, restart it:
+  ```bash
+  sudo systemctl restart lightdm
+  ```
+
+- If using **GDM** (GNOME Display Manager), restart it:
+  ```bash
+  sudo systemctl restart gdm
+  ```
+
+
+
+### 8. **Update System 💻🔄**
+
+Make sure your system is up to date, as outdated packages may cause display issues.
+
+- Update your system:
+  ```bash
+  sudo pacman -Syu
+  ```
+
+This ensures all packages, including graphics drivers, are up to date.
+
+
+
+### 9. **Try Using a Different Display Server (Wayland vs Xorg) 🌙⚙️**
+
+If you are facing issues with **Xorg**, try using **Wayland** instead, which is another display server protocol.
+
+- On GNOME, you can choose Wayland or Xorg from the login screen (click the gear icon after selecting your user).
+
+
+
+### 10. **Reboot Your System 🔄💻**
+
+Sometimes, a simple reboot can fix display issues:
+
+```bash
+sudo reboot
+```
+
+
+
+### Conclusion 🎉
+
+Display issues on Snigdha OS can usually be fixed by ensuring proper cables, checking drivers, and configuring the display settings. If problems continue, check for hardware faults or consult the Snigdha OS or Arch community for further assistance. 
+
+Enjoy your display! 🖥️🎨

docs/troubleshoot/troubleshoot-nvidia-on-snigdha-os.md

@@ -0,0 +1,189 @@
+---
+sidebar_position: 4
+---
+
+# Troubleshooting NVIDIA Issues
+
+If you're facing issues with NVIDIA graphics or the proprietary NVIDIA driver on Snigdha OS, follow these steps to properly install, configure, and troubleshoot your NVIDIA driver setup.
+
+
+
+### 1. **Ensure Your System is Updated 🖥️🔄**
+
+Before installing or troubleshooting drivers, make sure your system is fully updated to avoid compatibility issues.
+
+- Update your system:
+  ```bash
+  sudo pacman -Syu
+  ```
+
+- Reboot your system after the update:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### 2. **Check for Existing NVIDIA Drivers 🕵️‍♂️**
+
+First, verify if the NVIDIA driver is already installed or partially installed.
+
+- Check for the installed NVIDIA package:
+  ```bash
+  pacman -Qs nvidia
+  ```
+
+- If you see packages like `nvidia`, `nvidia-utils`, or `nvidia-dkms`, it indicates the driver is installed.
+
+
+
+### 3. **Install the Proprietary NVIDIA Driver 🖱️🖥️**
+
+#### **Install NVIDIA Drivers on Snigdha OS**
+Snigdha OS, being based on Arch Linux, supports the **proprietary NVIDIA drivers** provided by **nvidia** package, which provides full support for gaming, rendering, and GPU acceleration.
+
+1. **For NVIDIA 390xx Legacy Cards** (older models):
+   ```bash
+   sudo pacman -S nvidia-390xx
+   ```
+
+2. **For Latest NVIDIA Drivers (most common)**:
+   ```bash
+   sudo pacman -S nvidia nvidia-utils
+   ```
+
+3. **For the NVIDIA Optimus (Hybrid Graphics)**:
+   If you have a laptop with both Intel and NVIDIA graphics (Optimus), you may want to install the `bumblebee` or `nvidia-prime` package:
+   
+   - For **Bumblebee** (for better battery life and automatic switching):
+     ```bash
+     sudo pacman -S bumblebee primus
+     sudo systemctl enable bumblebeed
+     sudo systemctl start bumblebeed
+     ```
+
+   - For **NVIDIA Prime** (useful for newer systems):
+     ```bash
+     sudo pacman -S nvidia-prime
+     ```
+
+
+
+### 4. **Configure Xorg for NVIDIA 🖥️⚙️**
+
+Snigdha OS should automatically configure Xorg to use the NVIDIA driver upon installation. If it doesn’t work, you can manually configure it by creating or modifying the Xorg configuration.
+
+- Create the NVIDIA configuration file:
+  ```bash
+  sudo nvidia-xconfig
+  ```
+
+- Restart the Xorg server or reboot the system:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### 5. **Verify the Installation ✅**
+
+After installing or reconfiguring the NVIDIA drivers, verify the installation using the following commands:
+
+- Check if NVIDIA modules are loaded correctly:
+  ```bash
+  lsmod | grep nvidia
+  ```
+
+- Check the NVIDIA driver version:
+  ```bash
+  nvidia-smi
+  ```
+
+This will show you information about the installed NVIDIA driver, including the GPU model, driver version, and usage statistics.
+
+
+
+### 6. **Troubleshooting Common Issues 🛠️**
+
+#### **No Display / Blank Screen 💻❌**
+
+1. Ensure that the driver is properly loaded by checking the Xorg log:
+   ```bash
+   cat /var/log/Xorg.0.log | grep nvidia
+   ```
+
+2. If you still have no display, try booting into **recovery mode** and reinstall the drivers.
+
+#### **Optimizing Hybrid Graphics (Optimus) 🖥️🔋**
+
+If you're using an Optimus laptop with both Intel and NVIDIA, ensure that you're using either **Bumblebee** or **nvidia-prime** to manage the GPU switching.
+
+- Test if Bumblebee is working with the `optirun` command:
+  ```bash
+  optirun glxgears
+  ```
+
+- For **NVIDIA Prime**, you can switch between the Intel GPU and the NVIDIA GPU using:
+  ```bash
+  sudo prime-select nvidia  # To use the NVIDIA GPU
+  sudo prime-select intel   # To switch back to the Intel GPU
+  ```
+
+#### **Black Screen After Boot 💻❌**
+
+1. If the system boots into a black screen, try the following:
+   - Boot into a terminal or recovery mode and check the **Xorg logs** for errors.
+   - Check the logs at `/var/log/Xorg.0.log` or `dmesg` for NVIDIA driver-related errors.
+
+2. If needed, you can remove the NVIDIA drivers:
+   ```bash
+   sudo pacman -Rns nvidia nvidia-utils
+   ```
+
+   And then reinstall or switch to **nouveau** (open-source NVIDIA driver):
+   ```bash
+   sudo pacman -S xf86-video-nouveau
+   ```
+
+
+
+### 7. **Reinstall or Update NVIDIA Drivers 🔄**
+
+If you encounter persistent issues, try reinstalling the drivers:
+
+- Uninstall the NVIDIA drivers:
+  ```bash
+  sudo pacman -Rns nvidia nvidia-utils
+  ```
+
+- Reinstall the drivers:
+  ```bash
+  sudo pacman -S nvidia nvidia-utils
+  ```
+
+
+
+### 8. **Check for Kernel Compatibility 🐧🛠️**
+
+The NVIDIA driver requires a compatible kernel. If you recently updated your kernel or switched to a custom one, you may need to install the correct kernel modules.
+
+- For the **Zen Kernel** (often used in Snigdha OS):
+  ```bash
+  sudo pacman -S linux-zen
+  ```
+
+- For other kernel versions, such as **linux-lts** (Long Term Support):
+  ```bash
+  sudo pacman -S linux-lts
+  ```
+
+- After installing a new kernel, you will need to rebuild or reinstall the NVIDIA kernel module:
+  ```bash
+  sudo pacman -S nvidia-dkms
+  ```
+
+
+
+### Conclusion 🚀
+
+By following these steps, you should be able to install, configure, and troubleshoot NVIDIA drivers on Snigdha OS. If you continue to experience issues, checking the **NVIDIA** and **Arch Wiki** documentation, as well as visiting Snigdha OS community forums, might help. Happy computing! 😄🎮

docs/troubleshoot/troubleshoot-sound-on-snigdha-os.md

@@ -0,0 +1,190 @@
+---
+sidebar_position: 3
+---
+
+# Troubleshooting Sound Issues
+
+If you're having trouble with sound on Snigdha OS, follow these steps to diagnose and resolve the issue. Whether it's no sound, low volume, or distorted audio, let's get your audio working properly! 🔧🎶
+
+
+
+### 1. **Check the Audio Output 🔌🔊**
+
+#### **Ensure the Correct Output Device is Selected**
+Sometimes, the wrong audio output device might be selected, especially if you have multiple devices (like speakers, headphones, or HDMI output).
+
+- Open **PulseAudio Volume Control**:
+  ```bash
+  sudo pacman -S pavucontrol
+  pavucontrol
+  ```
+  
+- Go to the **Playback** tab and check that the audio is routed to the correct device.
+- In the **Output Devices** tab, make sure the desired audio output (e.g., headphones, speakers) is selected and not muted.
+
+
+
+### 2. **Check Volume Levels 🔊🎛️**
+
+#### **Ensure Volume is Turned Up**
+- Make sure the system volume is not muted or set too low.
+- You can adjust the volume with the sound settings in your desktop environment or use the command line:
+
+  - To check the volume with **`amixer`**:
+    ```bash
+    amixer sget Master
+    ```
+
+  - To increase the volume:
+    ```bash
+    amixer sset Master 50%+
+    ```
+
+  - To unmute:
+    ```bash
+    amixer sset Master unmute
+    ```
+
+
+
+### 3. **Check Audio Driver Installation 🔧🎶**
+
+#### **Is the Audio Driver Installed?**
+Snigdha OS uses **ALSA** (Advanced Linux Sound Architecture) and **PulseAudio** to manage audio. Ensure that the correct drivers are installed for your sound card.
+
+- For **Intel HD Audio**:
+  ```bash
+  sudo pacman -S alsa-utils
+  sudo pacman -S alsa-firmware
+  ```
+
+- For **Realtek Audio** (often found on laptops):
+  ```bash
+  sudo pacman -S alsa-utils
+  ```
+
+- For **NVIDIA HDMI Audio**:
+  ```bash
+  sudo pacman -S nvidia
+  ```
+
+- After installing, restart your system:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### 4. **Restart PulseAudio 🔄🔊**
+
+Sometimes, restarting **PulseAudio** can resolve sound issues.
+
+- To restart PulseAudio, run:
+  ```bash
+  pulseaudio -k
+  pulseaudio --start
+  ```
+
+- You can also restart the service with:
+  ```bash
+  sudo systemctl --user restart pulseaudio
+  ```
+
+
+
+### 5. **Check ALSA Mixer Levels 🎚️**
+
+#### **Adjust ALSA Mixer Settings**
+The ALSA mixer might have some channels muted or set to low levels, which can cause sound problems.
+
+- Open the ALSA mixer:
+  ```bash
+  alsamixer
+  ```
+
+- Use the arrow keys to navigate and adjust volume levels.
+- Unmute any muted channels by pressing `M` (if they are muted).
+
+
+
+### 6. **Test Audio with `aplay` 🎧**
+
+You can test if the system is producing audio by using `aplay`, a command-line sound player.
+
+- Test the sound card with a sample sound:
+  ```bash
+  aplay /usr/share/sounds/alsa/Front_Center.wav
+  ```
+
+- If you hear the sound, the audio system is working. If not, it might indicate a deeper issue with your audio configuration.
+
+
+
+### 7. **Check for Audio Errors in Logs 📝🔍**
+
+Check the system logs to see if there are any relevant error messages related to sound.
+
+- View PulseAudio logs:
+  ```bash
+  journalctl --user -u pulseaudio
+  ```
+
+- View ALSA logs:
+  ```bash
+  dmesg | grep -i audio
+  ```
+
+
+
+### 8. **Reconfigure Audio Settings 🔧🎶**
+
+#### **Reconfigure ALSA and PulseAudio**
+Sometimes, resetting the audio configuration can resolve conflicts:
+
+- Delete the PulseAudio configuration:
+  ```bash
+  rm -r ~/.config/pulse/
+  ```
+
+- Reset ALSA:
+  ```bash
+  sudo alsactl restore
+  ```
+
+- Restart your system:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### 9. **Update Your System 💻🔄**
+
+Ensure your system is up-to-date, as updates can fix bugs related to sound.
+
+- Update your system:
+  ```bash
+  sudo pacman -Syu
+  ```
+
+
+
+### 10. **Try Different Audio Tools 🎶🔊**
+
+If the problem persists, consider trying different audio tools like **PipeWire** or **Jack**.
+
+- For **PipeWire** (a modern audio server):
+  ```bash
+  sudo pacman -S pipewire
+  ```
+
+- After installing, restart your system:
+  ```bash
+  sudo reboot
+  ```
+
+
+
+### Conclusion 🎉
+
+Sound issues on Snigdha OS can be caused by many factors, such as incorrect drivers, muted settings, or configuration problems. Follow this guide step by step to resolve most common sound issues. If the problem persists, check the community forums or support channels for additional help. Enjoy your sound! 🔊🎶

docs/troubleshoot/troubleshoot-wifi-on-snigdha-os.md

@@ -0,0 +1,151 @@
+---
+sidebar_position: 1
+---
+
+# Troubleshooting Wi-Fi Issues
+
+If you're facing Wi-Fi connectivity issues on Snigdha OS, don’t worry! Follow this guide to resolve the problem. It covers common issues and solutions. Let's get your Wi-Fi back up and running! 😄
+
+
+
+### 1. **Check Wi-Fi Adapter 🏠🔍**
+
+#### **Is Your Wi-Fi Adapter Recognized?**
+First, check if Snigdha OS recognizes your Wi-Fi adapter.
+
+- Open a terminal and run:
+  ```bash
+  ip link
+  ```
+  Look for your Wi-Fi interface (usually named `wlan0`, `wlp2s0`, or similar). If it’s not listed, your adapter might not be recognized or the driver may be missing.
+
+#### **Install Drivers 🚗💨**
+If your Wi-Fi adapter is not detected, you may need to install additional drivers.
+
+- Check for available Wi-Fi drivers:
+  ```bash
+  sudo pacman -Ss wifi
+  ```
+  Install the appropriate driver for your device:
+  ```bash
+  sudo pacman -S <driver-name>
+  ```
+
+
+
+### 2. **Check Wi-Fi Network Status 📶🔌**
+
+#### **Make Sure Your Network is Active**
+Ensure that the Wi-Fi network you're trying to connect to is functioning properly. Try connecting with another device to verify the network works.
+
+#### **Restart Your Router 🔄**
+If there are issues, try restarting your router by turning it off and on again.
+
+
+
+### 3. **NetworkManager Issues ⚙️**
+
+Snigdha OS uses **NetworkManager** to manage network connections. If it’s causing issues, try restarting it.
+
+- Restart NetworkManager:
+  ```bash
+  sudo systemctl restart NetworkManager
+  ```
+
+Check the status of NetworkManager:
+```bash
+sudo systemctl status NetworkManager
+```
+
+
+
+### 4. **Verify Wireless Interface is Up 📡🆙**
+
+Sometimes, the wireless interface might be down. Bring it up with this command:
+
+```bash
+sudo ip link set wlan0 up
+```
+Replace `wlan0` with your correct interface name if it’s different.
+
+
+
+### 5. **Check Wi-Fi Configuration 🛠️**
+
+#### **NetworkManager Configuration 🖧**
+- Open **NetworkManager** and ensure your Wi-Fi network is listed. If it’s not, scan for networks again:
+  ```bash
+  nmcli dev wifi rescan
+  ```
+
+To connect to a network:
+```bash
+nmcli dev wifi connect <SSID> password <password>
+```
+
+
+
+### 6. **Check for Conflicting Software ⚠️🛑**
+
+Sometimes, software like `netctl` or `wpa_supplicant` can conflict with NetworkManager.
+
+- Disable `netctl`:
+  ```bash
+  sudo systemctl disable netctl
+  sudo systemctl stop netctl
+  ```
+
+- Disable `wpa_supplicant`:
+  ```bash
+  sudo systemctl disable wpa_supplicant
+  sudo systemctl stop wpa_supplicant
+  ```
+
+
+
+### 7. **Check for IP Address Issues 🌐🛠️**
+
+If Wi-Fi is connected but you have no internet access, there may be an IP address issue.
+
+- To release and renew your IP address:
+  ```bash
+  sudo dhclient -r
+  sudo dhclient
+  ```
+
+
+
+### 8. **Check Logs for Errors 📝🔍**
+
+If the issue persists, checking the system logs might help.
+
+- View `dmesg` logs related to Wi-Fi:
+  ```bash
+  dmesg | grep wlan
+  ```
+
+Look for error messages related to your Wi-Fi device, such as missing firmware or drivers.
+
+
+
+### 9. **Test Using a Different Network 🌍📶**
+
+If your Wi-Fi issue persists, try connecting to a different Wi-Fi network, like a mobile hotspot or another router, to see if the issue is with your device or the original network.
+
+
+
+### 10. **Reboot Your System 🔄💻**
+
+Sometimes, a simple reboot can fix the problem:
+
+```bash
+sudo reboot
+```
+
+
+
+### Conclusion 🎉
+
+Wi-Fi issues on Snigdha OS can usually be resolved by checking the adapter, ensuring drivers are installed, and troubleshooting with NetworkManager. If problems continue, check your hardware or consult the Snigdha OS or Arch community. 
+
+Happy browsing! 🌐🚀