WolfieWeb Raspberry Pi Lab
Beginner Friendly Build Guides

Simple Raspberry Pi Tutorials With Real Instructions

These projects are meant to be finished, not just admired. Each tutorial now gives you the exact goal, parts, wiring, build steps, code, testing checks, mistakes to avoid, and a small upgrade path.

Start with the LED. Then add button input, sensors, camera work, and motion detection. That path teaches the basics in the right order.

Start the Tutorials Back to WolfieWeb
Raspberry Pi beginner electronics tutorials on a workbench
🎮 WolfieWeb Build Quest

Step 1 of 5: Raspberry Pi Basics

Progress: loading...
🍓 Pi Starter 🔧 Robot Builder ⚡ Wiring Rookie 🔌 Arduino Maker 🌐 IoT Explorer
➡️ Next: Build Your First Robot 📚 Jump to Tutorials 🏠 Back to WolfieWeb

Pick a Tutorial

Go in order if you are new. Skipping around is fine, but the early projects teach the pin numbering and wiring habits you need later.

1. LED Output 2. Button Input 3. Temperature Sensor 4. Camera Timelapse 5. Motion Alert
Guided Learning Path

Finish These in Order

This page now works like a mini-course. Each lesson builds on the last one, so beginners do not get dumped into random parts and confusing wiring.

1. LED OutputControl hardware with Python. 2. Button InputReact to a physical press. 3. TemperatureRead real-world sensor data. 4. CameraCapture and save images. 5. Motion AlertDetect movement automatically.
Raspberry Pi GPIO LED wiring on breadboard
Tutorial 1 · Beginner
Step 1 of 5 · Learn GPIO output

GPIO LED Output

Goal: Make an LED blink from Python so you understand GPIO output, resistor safety, and the difference between physical pin numbers and GPIO numbers.

What should happen: The LED turns on for one second, turns off for one second, and repeats.

Parts Needed

  • Raspberry Pi with Raspberry Pi OS
  • Breadboard
  • 1 LED
  • 220Ω or 330Ω resistor
  • 2 jumper wires

Helpful Starter Parts

A basic Raspberry Pi electronics kit with LEDs, resistors, jumper wires, and a breadboard will cover this first lesson and several lessons after it.

View Starter Parts →

Wiring Steps

  1. Connect GPIO17, physical pin 11, to one side of the resistor.
  2. Connect the other side of the resistor to the long LED leg.
  3. Connect the short LED leg to GND, physical pin 6.
  4. Do not skip the resistor. That is how LEDs get burned out.

Easy Build Steps

  1. Shut the Pi down before wiring.
  2. Build the circuit on the breadboard.
  3. Boot the Pi and open Terminal.
  4. Create led_blink.py.
  5. Paste the code and run python3 led_blink.py.

Mistakes to Avoid

  • Using physical pin 17 instead of GPIO17.
  • Putting the LED in backward.
  • Forgetting the resistor.
  • Loose jumper wires that look connected but are not.

Starter Code

from gpiozero import LED
from time import sleep

led = LED(17)

while True:
    led.on()
    sleep(1)
    led.off()
    sleep(1)
GPIO image zoom gallery active · V2

GPIO LED Wiring Images — Click Any Image to Enlarge

These images show the GPIO17 output path: physical pin 11 to the resistor, resistor to the LED long leg, and LED short leg to GND physical pin 6. The resistor stays in the circuit because skipping it can burn out the LED.

Close-up of LED resistor and GPIO jumper wiring

Suggested instruction image: close-up view of GPIO17 wire, resistor, LED legs, and ground wire.

Quick Test

Run the code. If the LED blinks, the wiring and Python setup are good. If it stays dark, flip the LED first. If that fails, move the jumper wire back to GPIO17 and check the ground pin.

Upgrade: Add two more LEDs and make a simple traffic light.

✔ Micro-win: You just controlled real hardware with Python.
Back to Learning Path Next Lesson: Button Input →
Raspberry Pi push button input wiring on breadboard
Tutorial 2 · Beginner
Step 2 of 5 · Learn button input

Push Button Input

Goal: Read a real button press from Python. This teaches GPIO input, internal pull-up resistors, clean breadboard button placement, and how the Pi reacts to a physical action.

What should happen: Press the button and the terminal prints a message. Release it and the program waits for the next press.

Parts Needed

  • Raspberry Pi with Raspberry Pi OS
  • Breadboard
  • 1 tactile push button
  • 2 jumper wires
  • Optional: LED from Tutorial 1 for the upgrade challenge

Helpful Button Parts

Small tactile buttons are cheap, useful, and perfect for robot controls, menus, smart-home triggers, and beginner input projects.

View Button Parts →

Wiring Steps

  1. Power off the Pi before wiring.
  2. Place the button across the center gap of the breadboard. This matters.
  3. Connect one button leg to GPIO2, physical pin 3.
  4. Connect the opposite button leg to GND, physical pin 6.
  5. The code uses the Pi’s internal pull-up resistor, so no extra resistor is needed for this version.

Easy Build Steps

  1. Wire the button while the Pi is powered off.
  2. Boot the Pi and open Terminal.
  3. Create button_test.py.
  4. Run python3 button_test.py.
  5. Press the button several times and watch the terminal.

Mistakes to Avoid

  • Putting both wires on the same side of the button.
  • Not seating the button across the breadboard center gap.
  • Mixing up GPIO2 physical pin 3 with physical pin 2.
  • Forgetting that this circuit is active-low because of the internal pull-up.

Starter Code

from gpiozero import Button
from signal import pause

button = Button(2)

def pressed():
    print("Button pressed!")

button.when_pressed = pressed

pause()
Button input image zoom gallery active · V2

Push Button Wiring Images — Click Any Image to Enlarge

These images show the button across the breadboard center gap, GPIO2 physical pin 3, ground, and the button press action. If this lesson fails, the button is usually rotated wrong or both wires are on the same side.

Close-up of push button wiring connected to Raspberry Pi GPIO and ground

Instruction image: top-down button wiring showing the breadboard gap clearly.

Quick Test

Press the button several times. The message should appear once per press. If it spams messages or never triggers, rotate the button or move the jumper wires to opposite sides of the button.

Upgrade: Use the button to control the LED from Tutorial 1. That turns this from a simple input lesson into a real control circuit.

Next-Level Upgrade: Button Controls the LED

from gpiozero import Button, LED
from signal import pause

button = Button(2)
led = LED(17)

button.when_pressed = led.on
button.when_released = led.off

pause()

What You Learned

  • GPIO output sends a signal from the Pi.
  • GPIO input reads a signal into the Pi.
  • A button needs correct breadboard placement or it will act dead.
  • Internal pull-up resistors keep the input from floating.

Real Project Ideas

  • Use the button as a robot start/stop switch.
  • Use it as a camera shutter button.
  • Use it to silence a motion alert.
  • Use multiple buttons as a small Pi menu controller.
✔ Micro-win: You just made the Pi respond to a real physical button press — and you can now use that button to control other hardware.
← Previous: LED Output Next Lesson: Temperature Sensor →
Raspberry Pi temperature sensor monitor with DS18B20 sensor and breadboard wiring
Tutorial 3 · Beginner Plus
Step 3 of 5 · Read sensor data

Temperature Sensor Monitor

Goal: Read real temperature data from a DS18B20 sensor and print clean readings in the terminal. This teaches sensor wiring, GPIO4 data input, pull-up resistors, and basic data logging.

What should happen: The terminal prints updated temperature readings every few seconds, and you can expand it into a CSV logger or dashboard.

Parts Needed

  • Raspberry Pi with Raspberry Pi OS
  • DS18B20 waterproof temperature sensor
  • 4.7kΩ resistor for the DATA pull-up
  • Breadboard
  • Jumper wires

Helpful Sensor Parts

The DS18B20 is a stronger beginner choice for a temperature monitor because it is durable, accurate enough for room projects, and easy to log over time.

View Sensor Parts →

Wiring Steps

  1. Connect DS18B20 VCC to 3.3V.
  2. Connect DS18B20 GND to Pi GND.
  3. Connect DS18B20 DATA to GPIO4, physical pin 7.
  4. Place a 4.7kΩ resistor between VCC and DATA. Do not skip this pull-up resistor.
  5. Power on only after checking the sensor wire order.

Easy Build Steps

  1. Wire the DS18B20 while the Pi is powered off.
  2. Enable the 1-Wire interface in Raspberry Pi configuration.
  3. Reboot the Pi.
  4. Create temp_monitor.py.
  5. Run the script and confirm stable readings.

Mistakes to Avoid

  • Forgetting the 4.7kΩ pull-up resistor.
  • Mixing up red, yellow, and black sensor wires.
  • Using GPIO numbering wrong: DATA goes to GPIO4, physical pin 7.
  • Expecting readings before enabling 1-Wire.

Starter Code: Read Temperature

from w1thermsensor import W1ThermSensor
from time import sleep

sensor = W1ThermSensor()

while True:
    temp_c = sensor.get_temperature()
    temp_f = temp_c * 9 / 5 + 32
    print(f"Temperature: {temp_c:.2f} C / {temp_f:.2f} F")
    sleep(3)
Temperature sensor image zoom gallery active · Final Boss

Temperature Sensor Wiring Images — Click Any Image to Enlarge

These images show the DS18B20 wiring path: 3.3V power, GPIO4 DATA, GND, and the 4.7kΩ pull-up resistor between VCC and DATA.

Final Boss Upgrade: Save Temperature to CSV

from w1thermsensor import W1ThermSensor
from datetime import datetime
from time import sleep
import csv
import os

sensor = W1ThermSensor()
file_name = "temperature_log.csv"
new_file = not os.path.exists(file_name)

with open(file_name, "a", newline="") as file:
    writer = csv.writer(file)
    if new_file:
        writer.writerow(["timestamp", "temp_c", "temp_f"])

    while True:
        temp_c = sensor.get_temperature()
        temp_f = temp_c * 9 / 5 + 32
        timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")

        writer.writerow([timestamp, round(temp_c, 2), round(temp_f, 2)])
        file.flush()

        print(f"{timestamp} | {temp_c:.2f} C | {temp_f:.2f} F")
        sleep(5)
DS18B20 temperature sensor wiring with pull-up resistor

Instruction image: use the wiring view to confirm power, ground, DATA, and the pull-up resistor before turning the Pi on.

Quick Test

Hold your hand around the sensor for a few seconds. The temperature should climb slightly. If it never changes, check GPIO4 and the pull-up resistor.

Upgrade: Save readings to CSV, graph them later, or show them on a small web dashboard.

✔ Micro-win: You just turned the Pi into a real data logger.
← Previous: Button Input Next Lesson: Camera Timelapse →
Raspberry Pi camera timelapse setup with camera module and ribbon cable
Tutorial 4 · Intermediate
Step 4 of 5 · Capture images

Camera Timelapse

Goal: Capture images at fixed intervals and save them in a folder. This teaches camera setup, file naming, automation, and the basics of computer vision projects.

What should happen: The Pi saves timestamped images automatically, then you can turn them into a timelapse video.

Parts Needed

  • Raspberry Pi
  • Raspberry Pi Camera Module
  • Camera ribbon cable
  • Small tripod or camera mount
  • Stable power supply

Helpful Camera Parts

A camera module, mount, and stable Pi power supply prevent the two most common beginner problems: shaky footage and random camera failures.

View Camera Parts →

Connection Steps

  1. Shut down and unplug the Pi.
  2. Open the camera connector latch gently.
  3. Insert the ribbon cable straight and fully.
  4. Close the latch and avoid sharp cable bends.
  5. Mount the camera so it does not move during capture.

Easy Build Steps

  1. Connect the camera module.
  2. Boot the Pi and test camera support.
  3. Create a folder named timelapse.
  4. Create timelapse.py.
  5. Run the script and check the output folder.

Mistakes to Avoid

  • Ribbon cable inserted backward or not fully seated.
  • Testing in a dark room and thinking the camera failed.
  • Using weak power that causes random crashes.
  • Moving the camera during the capture sequence.

Final Boss Timelapse Code

from picamera2 import Picamera2
from time import sleep
from datetime import datetime
import os

folder = "timelapse"
os.makedirs(folder, exist_ok=True)

camera = Picamera2()
camera.start()
sleep(2)

interval = 10
shots = 20

for i in range(shots):
    timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
    filename = f"{folder}/img_{timestamp}.jpg"

    camera.capture_file(filename)
    print(f"[{i + 1}/{shots}] Saved: {filename}")

    sleep(interval)

print("Timelapse complete.")
Camera timelapse image zoom gallery active · Final Boss

Camera Setup Images — Click Any Image to Enlarge

These images show the ribbon cable, camera module mount, saved output files, and the full camera timelapse system.

Raspberry Pi camera ribbon cable correctly installed

Instruction image: confirm the ribbon cable is straight, fully seated, and locked before booting the Pi.

Quick Test

Open the timelapse folder. You should see timestamped images. If no images appear, test the camera connection before editing the script.

Upgrade: Use motion detection to capture images only when something moves.

✔ Micro-win: You just built an automated image capture system.
← Previous: Temperature Sensor Next Lesson: Motion Alert →
Raspberry Pi PIR motion sensor alert setup with LED indicator
Tutorial 5 · Beginner Plus
Step 5 of 5 · Detect motion

PIR Motion Sensor Alert

Goal: Detect motion with a PIR sensor, trigger an LED alert, and optionally capture an image with the camera. This turns the Pi into a basic event-driven automation system.

What should happen: Move in front of the sensor and the terminal prints an alert. With the combo code, the camera saves a photo too.

Parts Needed

  • Raspberry Pi
  • PIR motion sensor module
  • 3 jumper wires
  • Optional LED and resistor for a visible alert
  • Optional camera module for motion snapshots

Helpful Motion Parts

A PIR sensor module is one of the easiest upgrades for smart rooms, simple alarms, camera triggers, and robot awareness projects.

View PIR Parts →

Wiring Steps

  1. Connect PIR VCC to 5V if your PIR module requires it.
  2. Connect PIR GND to Pi GND.
  3. Connect PIR OUT to GPIO14, physical pin 8.
  4. Optional: connect an LED to GPIO17 with a resistor for a visual alert.
  5. Give the PIR sensor 30 to 60 seconds to settle after power-up.

Easy Build Steps

  1. Wire the PIR sensor while the Pi is powered off.
  2. Boot the Pi and wait for the PIR to stabilize.
  3. Create motion_alert.py.
  4. Run the script.
  5. Walk across the sensor view, not straight at it.

Mistakes to Avoid

  • Testing immediately before the PIR has settled.
  • Pointing the PIR at a window, vent, fan, or heat source.
  • Using the wrong OUT pin in code.
  • Expecting perfect detection when walking directly toward the sensor.

Starter Code: Motion Alert

from gpiozero import MotionSensor
from signal import pause

pir = MotionSensor(14)

def motion_seen():
    print("Motion detected!")

pir.when_motion = motion_seen

pause()
PIR motion sensor image zoom gallery active · Final Boss

PIR Motion Sensor Wiring Images — Click Any Image to Enlarge

These images show the PIR wiring path: VCC power, OUT signal to GPIO14, and GND. The sensor needs a short warm-up period before testing.

Final Boss Upgrade: Motion Triggers LED + Camera

from gpiozero import MotionSensor, LED
from picamera2 import Picamera2
from datetime import datetime
from signal import pause
import os

pir = MotionSensor(14)
led = LED(17)

camera = Picamera2()
camera.start()

folder = "motion_captures"
os.makedirs(folder, exist_ok=True)

def motion_detected():
    led.on()

    timestamp = datetime.now().strftime("%Y-%m-%d_%H-%M-%S")
    filename = f"{folder}/motion_{timestamp}.jpg"

    camera.capture_file(filename)
    print("Motion detected! Image saved:", filename)

def motion_stopped():
    led.off()
    print("Motion stopped")

pir.when_motion = motion_detected
pir.when_no_motion = motion_stopped

pause()
PIR motion sensor connected to Raspberry Pi with VCC OUT and GND wires

Instruction image: verify VCC, OUT, and GND before testing. PIR modules often need a short warm-up period.

Quick Test

Wait one minute after boot, then move across the sensor’s field of view. If it triggers constantly, aim it away from windows, vents, and heat sources.

Upgrade: Combine this with the camera lesson to save a photo only when motion is detected.

✔ Micro-win: You just built the foundation for a motion-triggered smart camera.
← Previous: Camera Timelapse Build a Real Project →
Keep Users Moving

Ready for Real Projects?

Once the basics are working, combine them. LEDs become status lights, buttons become controls, sensors become triggers, and the camera becomes proof that something happened.

Smart Motion Camera

Use the PIR sensor to trigger the camera and save a photo only when motion is detected.

Review Motion Lesson →

Room Monitor

Use the temperature sensor to track room conditions and later save the readings to a CSV file.

Review Sensor Lesson →

Beginner Robot Controls

Use buttons, LEDs, and sensors as the control foundation for later robot and IoT builds.

Explore More Builds →

Share This Tutorial Page

Send this page to someone starting with Raspberry Pi. It is built to get beginners moving without dumping them into confusing random videos.

Learning Path Copy Link
NEXT QUEST

Keep Building

You finished this stop in the WolfieWeb build path. Keep going while the wiring and logic are still fresh.

➡️ Next: Build Your First Robot