README
¶
Janice
A desktop app for viewing large JSON files.
Contents
Description
Janice is a desktop app for viewing large JSON files. It's key features are:
- Browse through a JSON document in classic tree structure
- JSON files can be opened via file dialog, from clipboard, dropped on the window or given as command line argument
- Supports viewing very large JSON files (>100MB, >10M elements)
- Search for keys and values in the document. Supports wildcards.
- Export parts of a JSON file into a new file or to clipboard
- Copy values to clipboard
- Single executable file, no installation required
- Desktop app that runs on Windows, Linux and macOS
- Automatic dark and light theme
Screenshots
Light theme
Dark theme
How to run
To run Janice just download and unzip the latest release to your computer. Janice ships as a single executable file that can be run directly. You find the latest packages for download on the releases page.
Linux
[!NOTE] The app is shipped in the AppImage format, so it can be used without requiring installation and run on many different Linux distributions.
- Download the latest AppImage file from the releases page and make it executable.
- Execute it to start the app.
[!TIP] Should you get the following error:
AppImages require FUSE to run., you need to first install FUSE on your system. Thi s is a library required by all AppImages to function. Please see this page for details.
Windows
- Download the windows zip file from the latest release on Github.
- Unzip the file into a directory of your choice and run the .exe file to start the app.
Mac OS
- Download the darwin zip file from the latest release on Github for your respective platform (arm or intel).
- Unzip the file into a directory of your choice
- Run the .app file to start the app.
[!TIP] MacOS may report this app incorrectly as "damaged", because it is not signed with an Apple certificate. You can remove this error by opening a terminal and running the following command. For more information please see Fyne Troubleshooting:
sudo xattr -r -d com.apple.quarantine Janice.app
Build and run from repository
If your system is configured to build Fyne apps, you can build and run this app directly from the repository with the following command:
go run github.com/ErikKalkoken/janice@latest
For more information on how to configure your system for Fyne please see: Getting Started.
FAQ
What is the largest JSON file that I can load?
The largest JSON file you can load on your computer depends mainly on how much RAM you have and on the particular JSON file. The main driver for memory consumption is the number of elements in a JSON document.
For comparison we did a load test on one of our developer notebooks. It has 8 GB RAM and runs Ubuntu 22.04 LTS. We were able to load a JSON files successfully with up to 45 million elements. The size of our test file was about 2.5 GB.
Are JSON files formatted?
Yes. The JSON document is rendered as tree and keys are shown in alphabetical order.
Attributions
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
github
package github contains features for accessing repos on Github.
|
package github contains features for accessing repos on Github. |
|
jsondocument
Package jsondocument contains the logic for rendering a Fyne tree from a JSON document.
|
Package jsondocument contains the logic for rendering a Fyne tree from a JSON document. |
|
ui
Package ui contains the user interface.
|
Package ui contains the user interface. |
|
tools
|
|
|
generate_json
This is a tool for generating large JSON files with random content for testing.
|
This is a tool for generating large JSON files with random content for testing. |
|
multiply_json
This is a tool for generating large JSON files by multiplying an existing json document
|
This is a tool for generating large JSON files by multiplying an existing json document |