Skip to content

exiahuang/vmark

Repository files navigation

πŸš€ Vmark - Keyboard-Driven New Tab Manager for Chrome

Chrome Extension MIT License TypeScript React

⚑ Replace your new tab page with a blazing fast, keyboard-first tab navigation system.
Open-source. Privacy-first. 100% local.


✨ Why Vmark?

Vmark transforms Chrome's new tab into a powerful command center for your browsing. Built for power users, developers, and keyboard enthusiasts who want to navigate tabs, bookmarks, and history at the speed of thought.

🎯 Key Highlights

Feature Description
⌨️ Vim-style Navigation Full keyboard control with j/k, 1-9, h/l shortcuts
πŸ—‚οΈ Auto-Categorization Tabs auto-sorted into Social, Tech, News, Cloud, LAN
πŸ“Œ Favorites & History Quick access to bookmarks and recent visits
🎨 8 Beautiful Themes From dark pink to ocean blue, forest green, and more
🌏 Multi-Language English, δΈ­ζ–‡, ζ—₯本θͺž support
πŸ”’ 100% Private All data stays in your browser, no tracking, no cloud
πŸͺΆ Lightweight < 250KB total, instant load
βš™οΈ Highly Configurable Custom categories, domains, rules, labels

πŸš€ Quick Start

Install from Chrome Web Store (Recommended)

πŸŽ‰ Coming soon! We're preparing the Web Store listing.

Manual Installation (Developer Mode)

  1. Clone this repository
    git clone https://github.com/exiahuang/vmark.git
    cd vmark
  2. Install dependencies
    npm install
    npm run build
  3. Open Chrome β†’ chrome://extensions
  4. Enable Developer mode (top-right toggle)
  5. Click Load unpacked β†’ Select the extension/ folder

⌨️ Keyboard Shortcuts

Navigation

Shortcut Action
j / k Move down / up
h / l Previous / Next category
gg / G First / Last item
1-9 Jump to tab 1-9
Enter / o Open selected
O Open in background

Tab Management

Shortcut Action
a / d Add / Remove bookmark
R Rename item
y / t Copy URL / Title
x Delete / Trash
z / Z Toggle group / All groups

Modes

Shortcut Action
/ Enter filter mode
: Enter command mode
? Help panel
S Settings
Esc Close / Back
Ctrl+0 Global Vmark shortcut

πŸ—‚οΈ Tab Categories

# Category Description
1 Current Currently open tabs
2 Favorites Your bookmarks
3 History Recent browsing history
4 Social Twitter/X, Facebook, Instagram, LinkedIn, Reddit
5 News Hacker News, CNN, BBC, Reuters
6 Reserved Custom slot for your needs
7 Tech GitHub, Stack Overflow, Medium, dev.to
8 Cloud Vercel, AWS, GCP, Azure, Alibaba Cloud
9 LAN Local network devices (192.168.x, localhost)

πŸ’‘ All categories 4-9 are fully customizable in Settings!


🎨 Themes

Theme Style
Default Dark pink/purple
Ocean Deep blue
Forest Nature green
Sunset Warm orange
Lavender Soft purple
Cherry Bold red
Mint Fresh green
Dracula Popular dark theme

🌏 Multi-Language Support

Vmark supports:

  • πŸ‡ΊπŸ‡Έ English
  • πŸ‡¨πŸ‡³ δΈ­ζ–‡ (Chinese)
  • πŸ‡―πŸ‡΅ ζ—₯本θͺž (Japanese)

Switch languages instantly in Settings β†’ Language.


πŸ”§ Configuration

Press S or : to open Settings:

  • Categories 1-3: Rename labels (Current β†’ My Tabs, etc.)
  • Categories 4-9: Customize name, domains, keywords, URL regex
  • Language: Switch between EN/ZH/JA
  • Theme: Choose from 8 beautiful themes
  • View Mode: Compact / Detailed / Grouped
  • Sort Mode: Time / Frequency

Changes apply immediately and persist after refresh.


πŸ› οΈ Tech Stack

Technology Purpose
React 18 UI framework
TypeScript Type-safe development
Vite Lightning-fast build tool
Zustand Lightweight state management
Chrome Extension API Tab, bookmark, history access

πŸ”’ Privacy & Security

  • βœ… No data collection - Everything stays local
  • βœ… No external requests - No analytics, no tracking
  • βœ… No cloud sync - Your data never leaves your browser
  • βœ… Open source - MIT license, fully auditable

🀝 Contributing

Contributions are welcome! Feel free to:

  • πŸ› Report bugs
  • πŸ’‘ Suggest features
  • πŸ”§ Submit pull requests
  • ⭐ Star the repo if you like it!

πŸ“„ License

MIT License - feel free to use, modify, and distribute.


πŸ”— Links


Built with ❀️ for keyboard enthusiasts and productivity geeks.
⭐ Star us on GitHub to support development!

About

Vmark - Keyboard New Tab Manager. Lightning-fast, keyboard-driven tab navigation. Auto-organize tabs, manage favorites, and browse history effortlessly.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors