# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

Basilisk II auto-installer for Linux (Arch and Debian/Ubuntu). Compiles Basilisk II from source and configures it to run classic Macintosh System 7 with a Quadra 900 emulation.

## Repository Contents

- `install.sh` - Main installer script (French comments)
- `Quadra.ROM` - Macintosh Quadra ROM file
- `HDD.img` - Hard disk image with System 7

## Running the Installer

```bash
git clone https://git.mahtan-melwasul.com/Mahtan/Macintosh.git
cd Macintosh
./install.sh           # Interactive mode
./install.sh -y        # Non-interactive (defaults)
./install.sh --help    # Show help
```

Requires `sudo` for package installation. Supported distributions: Arch Linux, Debian/Ubuntu.

## Interactive Options

The installer prompts for:
- Screen resolution (640x480, 800x600, 1024x768, 1280x1024)
- Color depth (8/16/24 bits)
- RAM (8/16/32/64 MB)
- Autostart at boot (systemd user service)
- Sound enable/disable
- Network enable/disable

## Installation Output

Files are installed to `~/.basilisk2/`:
- `bin/BasiliskII` - Compiled emulator binary
- `basilisk2_prefs` - Generated configuration
- `shared/` - Directory shared with emulated Mac (extfs)

Launch with `~/.basilisk2/run.sh` or `basilisk2` if `~/bin` is in PATH.

## Autostart (systemd)

If enabled, creates `~/.config/systemd/user/basilisk2.service`.

```bash
systemctl --user status basilisk2   # Check status
systemctl --user start basilisk2    # Manual start
systemctl --user disable basilisk2  # Disable autostart
```

## Emulator Configuration

Default settings in generated `basilisk2_prefs`:
- RAM: 16 MB
- Model: Quadra 900 (modelid 14, cpu 4, fpu enabled)
- Display: 800x600/8 DGA
- Network: disabled