# WolOS Manual

> How to use WolOS from the first start to your own scripts: install, the desktop, Settings, the Store, games, looks and the terminal, step by step with pictures.

Source: https://wolos.org/manual

- [Getting started](https://wolos.org/manual/getting-started.md): What WolOS is, what you need, and the way from the download to your own desktop, in five steps.
- [Installing WolOS](https://wolos.org/manual/install.md): Erase a disk, share it with Windows or Linux, or lay out partitions by hand. Nothing is written before you confirm the summary.
- [Installing next to Windows or Linux](https://wolos.org/manual/dual-boot.md): Share a disk: your other system keeps its files, gets smaller, and you pick one at start. What to do first, and what to do when the installer refuses.
- [Your first day](https://wolos.org/manual/first-day.md): Sign in for the first time, finish the setup, and spend ten minutes making WolOS yours: Wi-Fi, updates, looks and your first apps.
- [The desktop](https://wolos.org/manual/desktop.md): The menu bar, the Dock, windows, Search, switching apps and the four desktops: what each part of the screen is for and how to use it.
- [Control Center](https://wolos.org/manual/control-center.md): The panel at the top right for the things you change every day: Wi-Fi, Bluetooth, Focus, Dark Mode, brightness, sound, music and quick switches.
- [System Settings](https://wolos.org/manual/settings.md): The one window for everything you can change: how to open it, find any setting by typing, what every pane holds, and how to take a change back.
- [The Store](https://wolos.org/manual/store.md): Find an app, get it with one click, keep it up to date or go back to the version before, add a Kit, and remove what you no longer use.
- [Files and folders](https://wolos.org/manual/files.md): Find, open, copy, move, rename and delete your files in Files, get them back from the Trash, and check one for malware.
- [Updates](https://wolos.org/manual/updates.md): Keep WolOS and your apps up to date from System Settings and the Store, what happens while an update installs, and how WolOS goes back by itself when an update fails.
- [Backups and undo](https://wolos.org/manual/backups.md): Take back a setting you changed, go back to the system from before an update, and keep copies of your own files on a USB disk.
- [Privacy and permissions](https://wolos.org/manual/privacy.md): What apps may use and how you allow it, the questions WolOS asks on screen, the firewall and the malware check, and where to take any permission back.
- [Apps](https://wolos.org/manual/apps.md): The apps that come with WolOS, how to open, switch, quit and remove apps, and which apps open by themselves when you log in.
- [Web apps](https://wolos.org/manual/webapps.md): Turn a website you use every day into an app of its own: its own window and icon, in Apps, in Search and in the Dock.
- [Clipboard history](https://wolos.org/manual/clipboard.md): The last 25 things you copied, searchable, with pins for the snippets you paste every day. One-time codes are never kept.
- [Screenshots and markup](https://wolos.org/manual/screenshots.md): Pictures and recordings of the screen from the keyboard or the capture toolbar, and a pen to mark up a picture before you send it.
- [Notifications](https://wolos.org/manual/notifications.md): Banners at the top right, Notification Center for what you missed, Do Not Disturb and Focus for quiet, and what stays visible even then.
- [Sharing and devices](https://wolos.org/manual/sharing.md): Your computer's name on the network, Bluetooth headphones and mice, playing sound from an iPhone, sending files, and showing your screen on a second display.
- [Sound](https://wolos.org/manual/sound.md): Volume, speakers and headphones, the microphone, voice effects for calls, and what to do when there is no sound or it crackles.
- [Music and video formats](https://wolos.org/manual/media-formats.md): Play and make MP3, AAC, H.264, HEVC and AC3 files, and get the common fonts, with one click in the installer or the Store. Never added without you.
- [Battery and sleep](https://wolos.org/manual/power.md): Make the battery last or get full speed, what happens when you close the lid, the battery warnings, and Memory Saver.
- [Lock Screen and login window](https://wolos.org/manual/lock-screen.md): Lock the screen when you step away, choose when it locks by itself, and sign in from the login window, with a hint after three wrong passwords.
- [Games](https://wolos.org/manual/games.md): Which games run on WolOS and where to get them: the Store's Play shelf, Steam with your existing library, Windows games from elsewhere, and the Gaming module.
- [Steam and your game library](https://wolos.org/manual/steam.md): Open Steam, sign in and play the games you already own. Windows games run through Steam's own compatibility tool, which Steam keeps up to date.
- [Playing full screen](https://wolos.org/manual/full-screen-games.md): What WolOS does while a game fills the screen: banners wait, frames go out at once, the refresh rate follows the game, and Force Quit still opens.
- [When a game will not start](https://wolos.org/manual/game-fixes.md): One command checks everything Steam and Windows games need on this computer and prints the exact fix for each missing piece.
- [Creative apps in one step](https://wolos.org/manual/creative-module.md): The Creative module adds nine apps for drawing, photos, video, 3D, streaming and music in one step, with colour management and low-latency sound.
- [Dark Mode](https://wolos.org/manual/dark-mode.md): Light text on dark backgrounds everywhere, all the time or only in the evening, switched in one click from Control Center.
- [Night Shift](https://wolos.org/manual/night-shift.md): Warmer screen colours for the evening, on and off from Control Center, the keyboard or System Settings > Displays.
- [Wallpapers](https://wolos.org/manual/wallpapers.md): Choose the picture behind your windows: one that changes with the time of day, one of WolOS's own, or a photo of yours, and make a matching theme from it.
- [The Dock and the menu bar](https://wolos.org/manual/dock.md): Make the Dock bigger or smaller, let it grow under the pointer or hide until you need it, choose what the menu bar shows, and place windows side by side with tiling.
- [The keyboard](https://wolos.org/manual/keyboard.md): How fast keys repeat, keyboard layouts for other languages, and changing or adding a keyboard shortcut.
- [Looks and themes](https://wolos.org/manual/themes.md): Light, Dark or Auto, an accent colour, a gallery of themes that restyle the whole desktop and your apps, and a theme made from your wallpaper.
- [Arranging widgets](https://wolos.org/manual/widgets-edit.md): Edit Widgets: add cards from the gallery in three sizes, drag them where you want them, and take them off again.
- [What a terminal is](https://wolos.org/manual/terminal.md): The window where you type instead of click: what the prompt, a command, an argument and a path are, how to copy and paste, Tab, Ctrl+C, and your first five commands.
- [zsh basics](https://wolos.org/manual/zsh-basics.md): The shell in every WolOS terminal: history, Tab, suggestions, the colours of a command line, wildcards, pipes, saving output to a file, and your own settings.
- [PowerShell basics](https://wolos.org/manual/powershell-basics.md): Use PowerShell on WolOS: add it, open it, the Verb-Noun commands, objects in the pipeline, help, and making it the shell of every new terminal window.
- [Your first Ruby script](https://wolos.org/manual/ruby-script.md): Write a small Ruby script in a text editor, check it with wol script check, run it with wol script run, and see what WolOS asks before a script changes anything.
- [The terminal and the wol command](https://wolos.org/manual/wol-basics.md): Open Terminal, ask wol for help, read before you change, undo a change, and see why some commands ask for your password. Ten commands worth knowing.
- [Scripts and shells](https://wolos.org/manual/scripts-and-shells.md): Run sh, bash and Ruby scripts with wol script: checked before they run, as you, every change asked on screen and every run recorded. And choose the shell new terminal windows open in, PowerShell included.
- [Modules: tools for what you do](https://wolos.org/manual/modules.md): Developer tools, AI assistants, creative apps, games and a richer terminal, each added in one step from Settings > Modules and removed in one step.
- [Plugins: add to the desktop itself](https://wolos.org/manual/plugins.md): Weather in the menu bar, a timer in Control Center, a clock on the desktop: get a plugin in the Store, see what it asks for, turn it on and off, and make your own.
- [Secure Boot](https://wolos.org/manual/secure-boot.md): An option in the installer. Every computer makes its own start-up keys; at most one blue key screen, once, with the password boot.
- [Startup Security](https://wolos.org/manual/startup-security.md): The Settings page that says how this computer starts: Secure Boot, whose keys it trusts, kernel lockdown, the security chip, the sealed system, and the one button that finishes a waiting setup.
- [Sessions: reopen last time's windows](https://wolos.org/manual/sessions.md): With the Sessions module, WolOS remembers your terminal and coding-agent windows and offers once at login to reopen them on their desktops, in their folders.
- [Low-latency sound](https://wolos.org/manual/audio-latency.md): Set the sound delay for recording, live monitoring and music apps in Settings > Sound > Pro Audio, down to 64 samples (1.3 ms), and see dropouts.
- [Recovery: when something does not start](https://wolos.org/manual/recovery.md): The disk will not unlock, an update went wrong, a screen stays black, or a setting broke the desktop. What WolOS does on its own and what you can do.
- [Set up for development](https://wolos.org/manual/developer-module.md): The Developer module adds Git, a code editor, containers, runtimes for every language and Crystal with Cryswol in one step, and makes ~/Work for your projects.
- [Your first app in Crystal](https://wolos.org/manual/first-app.md): Write, build and run a small WolOS app in Crystal with Cryswol: it reads the system, tries to post a notification, and handles a refusal the way every app must.
- [Cryswol and Wolkit: apps made for WolOS](https://wolos.org/manual/cryswol-apps.md): What Cryswol, Wolkit and Crystal are, how they fit together, where to start, and where the complete developer documentation lives.