Notebook Data and Migration
How Your Data Is Stored
Section titled “How Your Data Is Stored”Mathcha Notebook stores your library in a single file named database.sqlite. It contains your documents, folder hierarchy, embedded images, saved document history, and editor settings. The folders shown in Notebook are part of this database, rather than separate folders on your computer.
Transferring this file transfers your library, including when moving between Windows, macOS, and Linux. Application data-location preferences and automatic backup files are stored separately.
Find Your Database
Section titled “Find Your Database”Open Menu > User Settings and click Open beside Data Location. The folder that opens contains database.sqlite. Use this method if you have changed the data location.
The usual locations are:
| Platform | Database file |
|---|---|
| Windows | %APPDATA%\Mathcha Notebook\db-data\database.sqlite |
| macOS | ~/Library/Application Support/Mathcha Notebook/db-data/database.sqlite |
| Linux | ~/.config/Mathcha Notebook/db-data/database.sqlite |
On Windows, paste the path into File Explorer’s address bar. On macOS, use Finder’s Go > Go to Folder. On Linux, enter the path in your file manager; the location can differ with XDG_CONFIG_HOME or packages such as Snap, so check Data Location for the actual folder.
If accessing another computer’s drive, look under that computer’s user profile. %APPDATA% and ~ otherwise refer to the current user.
Transfer to Another Computer
Section titled “Transfer to Another Computer”- Install the latest Mathcha Notebook on the destination computer and open it once.
- Find Data Location on each computer as described above. Note both folders.
- Fully quit Notebook on both computers before copying the database.
- Back up any existing
database.sqliteon the destination, then copy the sourcedatabase.sqliteinto the destination’s Data Location, keeping the same filename. - Open Notebook on the destination and check your documents, folders, and images. Keep the original file until you have verified the transfer.
Replacing the database replaces the destination library; it does not merge libraries. To add selected documents to an existing library, use .mathcha export and import instead.