Skip to content

A floating console Chrome extension that captures logs, warnings, and errors for quick debugging without opening DevTools

License

Notifications You must be signed in to change notification settings

milad-hub/float-console

Repository files navigation

Float Console

A simple floating console for Chromium-based browsers (Chrome, Edge, etc.) that shows your logs without opening DevTools. Sometimes you just need to see what's being logged, you know?

Float Console License Status Release

⚠️ Heads up: This is still being worked on and hasn't been released yet. Things might break, features might change, and it's not in any extension store. Use at your own risk!

⚠️ Important: This is just a simple log viewer, okay? It's not DevTools. It won't debug your code, won't show you network requests, won't profile performance, none of that fancy stuff. It just shows console logs. If you need real debugging, use DevTools like everyone else.

What it does

Basically, it's a floating window that shows your console.log, console.warn, console.error, and other console stuff. That's it. Nothing fancy.

Here's what you can do:

  • See your logs - All the console methods you're used to (log, warn, error, info, debug, table, group, etc.)
  • Filter stuff - Search through logs or filter by type
  • Pin logs - Keep important ones at the top
  • Copy logs - Copy individual logs or everything
  • Groups - Expand/collapse grouped logs
  • Long messages - Expand messages that are too long
  • Move it around - Drag it wherever you want
  • Resize it - Make it bigger or smaller
  • Dark mode - Because dark mode is better
  • Custom fonts - Change the font if you want
  • Keyboard shortcut - Set your own shortcut to toggle it

What it doesn't do

Just to be clear:

  • It's not DevTools. Don't expect breakpoints, network inspection, or any of that.
  • Log formatting might look slightly different than DevTools (we tried, but it's hard to match perfectly)
  • Objects are shown as text, not interactive inspectors
  • No debugging features - can't set breakpoints or step through code
  • Error details might be simpler than what DevTools shows

If you need real debugging, use your browser's DevTools. This is just for quick log viewing.

Installation

Build it yourself

  1. Clone the repo:
git clone https://github.com/milad-hub/float-console.git
cd float-console
  1. Install dependencies:
npm install
  1. Build it:
npm run build
  1. Load it in your browser:
    • Chrome: Go to chrome://extensions/
    • Edge: Go to edge://extensions/
    • Turn on "Developer mode" (top right)
    • Click "Load unpacked"
    • Pick the dist folder

How to use it

It's pretty straightforward. Click the floating button (or use your keyboard shortcut) to show/hide the console.

  • Move it: Drag the floating button around
  • Resize: Drag the edges of the console window
  • Filter: Type in the filter box or use the Types dropdown
  • Pin logs: Click the pin icon on any log
  • Delete logs: Click the X icon
  • Copy: Click the copy icon (or use the Copy button for all logs)
  • Expand groups: Click the chevron to expand/collapse groups
  • Expand long messages: Click the chevron on truncated messages

The settings are in the extension popup (click the extension icon). You can change the position, enable dark mode, adjust fonts, etc.

Development

If you want to hack on this:

# Install stuff
npm install

# Watch mode for development
npm run dev

# Build for production
npm run build

# Clean up
npm run clean

# Lint
npm run lint

# Fix linting
npm run lint:fix

# Format code
npm run format

We use ESLint and Prettier, so the code should be reasonably clean.

How it works

  • Content scripts intercept console calls and send them to the extension
  • Uses Shadow DOM so it doesn't mess with page styles
  • Messages are passed securely between content scripts and the extension
  • Logs are limited to 10,000 to keep memory usage reasonable
  • Everything stays local - no tracking, no external calls
  • Works with any Chromium-based browser (Chrome, Edge, Brave, etc.)

License

MIT - do whatever you want with it.

Issues

Found a bug? Want a feature? Open an issue on GitHub: https://github.com/milad-hub/float-console/issues


Made for developers who just want to see their logs without the DevTools overhead.

About

A floating console Chrome extension that captures logs, warnings, and errors for quick debugging without opening DevTools

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published