Feather is an extensible debug tool for LÖVE projects, inspired by LoveBird. It lets you inspect logs, variables, performance metrics, and errors in real-time over a network connection — perfect for debugging on desktop or mobile without stopping the game.

• 📜 Live log viewer — See print() output instantly in your browser.
• 🔍 Variable inspection — Watch values update in real-time.
• 🚨 Error capturing — Automatically catch and display errors with optional delivery delay.
• 🌐 Remote access — Connect via a browser from localhost or whitelisted IPs.
• ⚡ Performance-friendly — Configurable update interval to avoid frame drops.
• 🔌 Plugin support — Extend with custom data inspectors and views using React (Lua support for custom views coming soon).

1. Download Feather

• Download the latest release from the releases page

• Or install it via Luarocks

  luarocks install feather

1. Require Feather

   local Feather = require "feather"

local FeatherDebugger = require "feather"

local debugger = FeatherDebugger({
  debug = Config.__IS_DEBUG, -- Make sure to only run in debug mode
  wrapPrint = true,
  defaultObservers = true,
  autoRegisterErrorHandler = true,
})

function love.update(dt)
  debugger:update(dt) -- Required for processing requests
end

Feather:init(config) accepts the following options:

When running your game with Feather enabled, you'll see:

Listening on 127.0.0.1:4004

Install the feather app from the releases page, it will automatically connect to your game.

• Only enable debug = true in development builds — disable it for release for performance and security.
• Use wrapPrint = true to capture all print() logs automatically. print function will be wrapped with custom logic to send logs to Feather.
• Add custom variable observers to monitor your game's state.

• Hump Class
• Inspect
• json.lua

Observers are a way to inspect variables values in real-time. They are useful for debugging and observing game state.

  debugger:observe("Awesome player instance", player)

Feather will automatically capture and log print() calls in real-time, using the output type. You can also manually log using the log and print functions.

  debugger:print("Something happened")

  debugger:log({
    type = "awesome_log_type",
    str = "Something happened",
  })

Feather automatically includes trace in errors and logs. You can also manually log traces using the trace function.

  debugger:trace("Something happened")

Feather will automatically capture and log errors in real-time. You can also manually log errors using the error function.

  debugger:error("Something went wrong")

Feather comes with a plugin system that allows you to extend its functionality with custom data inspectors. Check out the Feather Plugins repository for more information.

Feel free to use and remix this project for personal, educational, or non-commercial fun.

Just don’t sell it, don’t make forks that let others sell it, and don’t use it for AI training — unless I say it’s okay.

Full license: See LICENSE.md

Inspired by LoveBird by rxi, with added flexibility, plugin support, and modern LÖVE integration.