Skip to content

Finfra/fSnippet_public

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

422 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

title fSnippet Pro
description macOS Menu Bar Snippet & Clipboard Manager
date 2026-03-26

ko

<img src="./manual/app-icon.png" width="28" alt="fSnippet Icon"> Product Page

Expand any text, Powerful snippet tool.

macOS Menu Bar Snippet & Clipboard Manager. Manage text snippets, track clipboard history, and expand frequently used text with shortcuts.

Editions

Edition Price Interface Version Install
fSnippet Pro (GUI) Paid GUI App Store (Coming Soon)
fSnippetCli (CLI) Free / OSS CLI v1.0.1 brew install finfra/tap/fsnippet-cli (Source)
  • fSnippet Pro - Full-featured GUI app with intuitive settings, visual snippet management, and clipboard history viewer. Available on the Mac App Store (coming soon).
  • fSnippetCli - Fully open-source CLI version. All source code is in the cli/ directory. Installable via Homebrew.

Installation (fSnippetCli)

The free, open-source CLI engine is distributed via Homebrew.

# 1. Add the tap and install
brew tap finfra/tap
brew install finfra/tap/fsnippet-cli

# 2. Start the background service (auto-starts on login)
brew services start fsnippet-cli

# 3. Verify the REST API is running
curl http://localhost:3015/api/v2/status

Service Management

brew services start fsnippet-cli     # Start (auto-start on login)
brew services stop fsnippet-cli      # Stop
brew services restart fsnippet-cli   # Restart
brew upgrade fsnippet-cli            # Update to the latest version

Uninstall

brew services stop fsnippet-cli      # Stop the service first
brew uninstall fsnippet-cli          # Remove the app
brew untap finfra/tap                # (optional) Remove the tap

Snippet data and settings in ~/Documents/finfra/fSnippetData/ are kept after uninstall. Delete that folder manually to remove all data.

Accessibility permission required. On first run, grant access in System Settings > Privacy & Security > Accessibility for key monitoring to work.

See cli/README.md for build-from-source and full details.

About This Repository

This repository serves two purposes:

  1. User support & documentation for fSnippet Pro (GUI, paid)
  2. Open-source repository for fSnippetCli (CLI, free)

Features

  • Instant Access - Quick access from the menu bar
  • Clipboard History - Track all copied text, images, and links
  • Fast Snippet Expansion - Expand frequently used text with shortcuts
  • Fine-grained Control - Exclude apps, customize shortcuts
  • Easy Management - Intuitive UI for snippet organization
  • Text & Image Support - Store both text and image snippets
  • AI Agent Integration - Automate with Claude, Gemini, and MCP

Recent Improvements (v1.0.1)

  • Robust HTTP Handling - Fixed partial read scenarios and premature EOF handling in REST API (Issue929, Issue923)
  • Brew Remote Deployment - Can now be installed directly from the remote Homebrew tap without manual setup (Issue167)
  • Enhanced Keyboard Capture - Improved right_command and special key detection in CGEventTap (Issue912, Issue165)
  • Better Settings Sync - Fixed folder rule batch-save and proper stale cache handling (Issue926)

AI Agent Integration

Automate and extend fSnippet with AI agents. All integration methods use the built-in REST API.

Platform Integration Method Details
Claude Marketplace Plugin (Skill) Install via Claude Code
Gemini Workflow Installation Install via Gemini
MCP Model Context Protocol Server MCP Server Setup

Requirements

  • macOS 14.0 or later

Product Page

Language Link
English fSnippet - Product Page
Korean fSnippet - 제품 페이지

Other Apps by Finfra

App Description Link
fWarrange The ultimate Mac window manager & layout restore Product Page
fBanner Clipboard to banner image, instantly Product Page
fBoard Your personalized screen board Product Page
fQRGen Clipboard to QR code, instantly Product Page
fGoogleSheet The fastest Google Sheets menu bar app for Mac Product Page

Documentation

Document Description
Manual User manual (KR/EN)
REST API REST API reference & OpenAPI spec
MCP Server Model Context Protocol server
Claude Code Skill Claude Code plugin
Localization Multi-language string resources (10 languages)

Community & Support

Issues

Board (English)

Category Link
Notice fSnippet Notice
Guide fSnippet Guide
QnA fSnippet QnA
Feedback fSnippet Feedback

Board (Korean)

Category Link
Notice fSnippet 공지
Guide fSnippet 사용법
QnA fSnippet QnA
Feedback fSnippet 피드백

License

Copyright (c) finfra.kr. All rights reserved.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors