You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<sub>Available for macOS, Windows, and Linux</sub>
46
43
</p>
47
44
48
-
## Support
45
+
<br>
46
+
47
+
<br>
49
48
50
-
massCode is an open-source project and completely free to use.
49
+
## Support
51
50
52
-
Maintaining and adding new features requires significant time and effort. If you find massCode useful, consider supporting its development. Your contribution helps keep the project alive and moving forward.
51
+
massCode is free and open source. But building and maintaining a quality tool takes time. Your support helps keep development going and new features coming.
53
52
54
-
You can support massCode through the following channels:
55
53
<divalign="center">
56
54
57
-
[](https://opencollective.com/masscode)
58
-
[](https://paypal.me/antongithub)
59
-
[](https://antonreshetov.gumroad.com/l/masscode)
60
-
[](https://buy.polar.sh/polar_cl_bpDmjg079kfiAVtdtrtBwxyRXN6NK8B4Bvqdk2QXdx7)
Organize your snippets with multi-level folders and tags. Each snippet can contain multiple fragments (tabs), giving you fine-grained control over structure and grouping.
69
-
70
-
### Editor
71
-
72
-
Built on [CodeMirror](https://github.com/codemirror/codemirror5) with `.tmLanguage` grammars for syntax highlighting.
73
-
74
-
* Supports over [600 grammars](https://github.com/github/linguist/blob/master/vendor/README.md), with 160+ available out of the box.
75
-
* Integrated [Prettier](https://prettier.io) for clean, consistent code formatting.
76
-
77
-
### Real-time HTML & CSS Preview
62
+
<palign="center">
63
+
<strong>SPONSORS</strong>
64
+
</p>
78
65
79
-
Write and instantly preview HTML and CSS snippets. Perfect for prototyping, testing ideas, or quick visual checks.
Full Markdown support with syntax highlighting, tables, lists, and more.
78
+
Originally a snippet manager, massCode now brings together snippets, notes, calculations, and developer tools in one desktop app, so everyday work stays in one place.
84
79
85
-
* Integrated [Mermaid](https://mermaid-js.github.io/mermaid/#) for dynamic diagrams and charts.
80
+
## Features
86
81
87
-
### Presentation Mode
82
+
### Code Snippets
88
83
89
-
Turn a sequence of snippets into a presentation. Useful for classrooms, team meetings, conference talks, or simply walking through your own notes.
84
+
Use massCode as a focused snippet workspace with multi-level folders, tags, and fragments for organizing reusable code across projects and languages.
90
85
91
-
### Mindmap
86
+
- 160+ syntax grammars out of the box (600+ supported via `.tmLanguage`)
87
+
- Integrated [Prettier](https://prettier.io) for code formatting
88
+
- Real-time HTML & CSS preview for quick prototyping
89
+
- JSON Visualizer for exploring nested structures as interactive graphs
90
+
- Export snippets as polished images with customizable themes
92
91
93
-
Generate mind maps from Markdown. Fast, intuitive, and ideal for structuring and visualizing ideas.
92
+
### Notes
94
93
95
-
### JSON Visualizer
94
+
Write longer markdown documents right next to your snippets: project docs, drafts, research notes, and personal knowledge bases.
96
95
97
-
Visualize and explore your JSON data with an interactive graph view. Perfect for quickly inspecting complex responses, APIs, or configuration files.
- Mind maps generated from markdown heading structure
99
+
- Fullscreen presentation mode for demos and meetings
100
+
- Callout blocks and image embedding
98
101
99
102
### Math Notebook
100
103
101
-
A calculator notepad inspired by [Numi](https://numi.app). Write expressions in naturallanguage and get instant results on each line. Supports arithmetic, percentages, unit conversions, 28 currencies with live rates, date & time operations, variables, and more.
104
+
A calculator-style notebook for natural-language calculations, conversions, and date math without leaving your workflow.
102
105
103
-
### Beautiful Screenshots
104
-
105
-
Export snippets as polished images with customizable themes and backgrounds.
106
+
- Arithmetic, percentages, unit conversions, and date/time math
107
+
- 166+ fiat currencies, 21 cryptocurrencies with live exchange rates
108
+
- Variables, functions, and aggregates for quick iterative calculations
-**Encoders:** URL, Base64, JSON to TOML/XML/YAML, Color Converter
118
+
-**Generators:** JSON Generator, Lorem Ipsum
116
119
117
-
Fully customize the UI and editor syntax highlighting with JSON theme files stored in `~/.massCode/themes/`. Supports light and dark types with live reload.
120
+
## Markdown Vault
118
121
119
-
### Integrations
122
+
Your snippets and notes live as plain `.md` files on disk with frontmatter metadata, so the data stays readable and portable.
120
123
121
-
Extend your workflow with:
124
+
-**Git-friendly** - track changes and sync via any Git remote
125
+
-**Cloud sync** - works with iCloud, Dropbox, Google Drive, Syncthing
126
+
-**Live sync** - massCode watches the vault and picks up external changes in real time
127
+
-**No vendor lock-in** - your data is always yours
122
128
123
-
*[VS Code Extension](https://marketplace.visualstudio.com/items?itemName=AntonReshetov.masscode-assistant): zen mode snippet search, instant insertion, and save selected code as snippets.
124
-
*[Raycast Extension](https://www.raycast.com/antonreshetov/masscode): quick snippet access directly from Raycast.
129
+
## Custom Themes
125
130
126
-
## Storage
127
-
128
-
massCode supports two storage engines — you can switch between them in **Settings → Storage**.
129
-
130
-
### Markdown Vault
131
-
132
-
The default storage engine. Snippets are stored as plain `.md` files on disk with frontmatter metadata. The vault structure mirrors your folder hierarchy.
133
-
134
-
***Git-friendly** — track changes, sync via GitHub or any Git remote.
135
-
***Cloud sync** — works with iCloud, Dropbox, Syncthing, or any file sync service.
136
-
***Live sync** — massCode watches the vault directory and picks up external changes in real time.
137
-
138
-
### SQLite (Legacy)
139
-
140
-
All data is stored in a single SQLite database file. SQLite engine is deprecated and will be removed in future versions. Please migrate to Markdown Vault.
141
-
142
-
## Overview
143
-
144
-
massCode was created as a personal learning project and evolved into an open-source tool. The goal: combine the best features of snippet managers (free and paid) into one flexible, developer-friendly application.
131
+
Customize the app UI and editor syntax highlighting with JSON theme files. Supports light and dark themes with live reload. See the [theme docs](https://masscode.io/documentation/themes.html).
145
132
146
133
## Build Locally
147
134
135
+
<details>
136
+
<summary>Instructions for building from source</summary>
137
+
148
138
### Prerequisites
149
139
150
140
- Node.js (>=20.16.0)
@@ -180,28 +170,30 @@ To run in development mode:
180
170
pnpm dev
181
171
```
182
172
183
-
This will start the application with hot reloading.
173
+
</details>
184
174
185
175
## Troubleshooting
186
176
187
-
### macOS
177
+
<details>
178
+
<summary>macOS: "massCode is damaged and can't be opened"</summary>
188
179
189
-
If you encounter the error message "massCode" is damaged and can't be opened. You should move it to the Trash while installing software on macOS, it may be due to security settings restrictions in macOS.
180
+
This is caused by macOSsecurity settings. Fix it with:
190
181
191
182
**Option 1: System Settings (macOS 13+)**
192
-
1. Open **System Settings** → **Privacy & Security**
193
-
2. Scroll down to find "massCode" in the list of blocked applications
194
-
3. Click **Allow Anyway** or **Open Anyway**
195
-
4. You may need to enter your administrator password
183
+
1. Open **System Settings** -> **Privacy & Security**
0 commit comments