I know that there is no perfect solution to edit JSON files like in a desktop environment, but stay with me as I have some good tips to share with you.<\/p>\n\n\n\n
Creating a JSON File in Linux Terminal<\/h2>\n\n\n\n
Basically, JSON files are simply text files formatted in a very specific way. While the formatting is strict, the content itself is just text, so you can use any text editor you like for this task.<\/p>\n\n\n\n
As JSON files are purely text files ending with a “.json” extension, you can simply create an empty JSON file with the Linux terminal by using the “touch” command: The “touch” command on Linux is widely used to create empty text files. But if your goal is to write the JSON file content, then it’s better to use a full editor. The two most popular are:<\/p>\n\n\n\n So, nothing terribly challenging for now, you can create JSON files with the “touch” or any text editor that runs in a terminal. But let’s see how to edit existing JSON files without messing up the formatting.<\/p>\n\n\n\n JSON files are generally fairly easy for humans to read, but writing them can be challenging. There is a full set of rules to keep in mind when you edit JSON files:<\/p>\n\n\n\n And sadly, it was a bit of a shock for me while doing the research for this article, there is no great editor for JSON files when you don’t have a GUI<\/a>.<\/p>\n\n\n\n That’s it, there is no good editor specifically built to edit JSON files in a Linux terminal, so we have to use the classic text editors you already know.<\/p>\n\n\n\n Basically, as JSON files are simply text files, you can use your favorite text editor for this (Nano, Vim, Emacs, etc.).<\/strong> Unlike YML files, JSON files are not strict about white spaces (space, tabs, newlines, etc.), so it should be fine.<\/p>\n\n\n\n It’s not perfect, but for simple edits it should be fine. For larger modifications, check the end of the article, I still have a few tips for you.<\/p>\n\n\n\n The main issue when working with JSON files in a Linux terminal is that it can be hard to read.<\/strong><\/p>\n\n\n\n As I mentioned earlier, white spaces are not standardized, so computers (and some humans) tend to generate or write JSON files all in one line.<\/p>\n\n\n\n They will often look like this:<\/p>\n\n\n\n While it might be fine for short files like this example, it’s not the most readable. Interested? Well, stay with me, you just need to install one package that will do this for you quickly.<\/p>\n\n\n\n “jq” is a command-line processor for Linux. It’s not a text editor, but it can transform a JSON file in different ways.<\/strong> I’ll show you how to use it to prettify your JSON files, but it can also do various tasks on JSON files (filtering, summarizing, inserting values, etc.).<\/p>\n\n\n\n For now, start by installing it on your system. If you’re using a Debian-based distribution, you can get it with: It’s a tiny package, so it should be installed pretty quickly.<\/p>\n\n\n\n If you’re new to the Linux command line, this article will give you the most important Linux commands<\/a> to know, plus a free downloadable cheat sheet to keep handy.<\/p>\n<\/div>\n<\/div>\n\n\n\n Now that jq is installed, you can start using it right away.<\/p>\n\n\n\n The main command you can use to display a JSON file properly follows this syntax : When you run it, it will display the file in your terminal directly (it doesn’t modify it), but it adds spaces, tabs and new lines to make it easier for us to read (unlike “cat” or other commands).<\/p>\n\n\n\n From there, if you want to save the changes to get a file directly formatted like that, you can redirect the output to another file: Once done, you can use Nano or Vim to edit the new file, which should be easier than the original one now that it’s formatted properly.<\/p>\n\n\n\n We have seen that there is no magical editor for JSON files in the Linux terminal, but it doesn’t mean you have to do everything manually.<\/p>\n\n\n\n I guess that if you’re reading this article about editing JSON files via the Linux terminal, it’s because you work on a Linux server that doesn’t have a GUI. But often, these servers have some kind of remote access enabled (typically SSH). <\/p>\n\n\n\n If you can access the Linux server via SSH, it means you can copy the JSON file’s content and use a full editor on your computer. Or even better, you can use a free online tool.<\/strong><\/p>\n\n\n\n While doing some research for this article, I stumbled upon this tool: JSON Editor Online<\/a>. It looks like this, and it was really what I was looking for, with features dedicated to the JSON format (adding objects, array, values, etc.).<\/p>\n\n\n\n But obviously, if you can copy the JSON file to your computer, you can also use traditional text editors like VS Code, Sublime Text, or Geany. You can find a list of my favorite code editors here<\/a>. All of them have features or plugins you can use to edit JSON files.<\/p>\n\n\n\n Overwhelmed with Linux commands? JSON files are widely used by developers to save configurations and share data across servers and applications. They’re built to be easy for both machines and people to understand. But if you only have a Linux terminal to work with, it’s not that easy. Let me give you a few tips to improve that. As…<\/p>\n","protected":false},"author":1,"featured_media":19232,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[27],"tags":[],"taxonomy_info":{"category":[{"value":27,"label":"Linux tutorials"}]},"featured_image_src_large":["https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/edit-json-linux-1024x683.jpg",1024,683,true],"author_info":{"display_name":"Patrick Fromaget","author_link":"https:\/\/raspberrytips.com\/author\/admin\/"},"comment_info":0,"category_info":[{"term_id":27,"name":"Linux tutorials","slug":"linux","term_group":0,"term_taxonomy_id":27,"taxonomy":"category","description":"","parent":0,"count":89,"filter":"raw","cat_ID":27,"category_count":89,"category_description":"","cat_name":"Linux tutorials","category_nicename":"linux","category_parent":0}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/posts\/19217"}],"collection":[{"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/comments?post=19217"}],"version-history":[{"count":29,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/posts\/19217\/revisions"}],"predecessor-version":[{"id":19887,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/posts\/19217\/revisions\/19887"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/media\/19232"}],"wp:attachment":[{"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/media?parent=19217"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/categories?post=19217"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/raspberrytips.com\/wp-json\/wp\/v2\/tags?post=19217"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
<\/strong>touch myfile.json<\/code><\/p>\n\n\n\n\n
nano myfile.json
<\/code>You can start writing immediately, but you may need a bit of time to understand the shortcuts available if it’s your first time (I have a guide here for you if needed<\/a>).![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/test-json-nano.jpg\")
<\/li>\n\n\n\n
Here is the command to do the same thing:
vim myfile.json
The interface is slightly different, but you can do similar things:![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/test-json-vim.jpg\")
I have a beginner’s guide about Vim<\/a> here (it’s for the Raspberry Pi, but it might help on any Linux computer).<\/li>\n<\/ul>\n\n\n\nEditing a JSON File in the Linux Terminal<\/h2>\n\n\n\n
\n
\n
Formatting JSON Files in the Terminal<\/h2>\n\n\n\n
The problem<\/h3>\n\n\n\n
![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/json-not-pretty-1024x176.jpg\")
<\/figure>\n\n\n\n
When you open the file, I guess you would prefer to have something like this:<\/p>\n\n\n\n![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/json-pretty-1024x624.jpg\")
<\/figure>\n\n\n\nSolution: Installing jq<\/h3>\n\n\n\n
sudo apt install jq<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/install-jq-1024x401.jpg\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2022\/11\/gift-icon.png\"){kind=icon}
<\/figure><\/div><\/div>\n\n\n\nPrettifying JSON files<\/h3>\n\n\n\n
jq . ugly.json<\/code><\/p>\n\n\n\n![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/jq-display.jpg\")
<\/figure>\n\n\n\njq . ugly.json > pretty.json<\/code><\/p>\n\n\n\nNeed a real editor for JSON files?<\/h2>\n\n\n\n
![\"\"](\"https:\/\/raspberrytips.com\/wp-content\/uploads\/2023\/08\/json-online-editor-1024x385.jpg\")
<\/figure>\n\n\n\nAdditional Resources<\/strong><\/h2>\n\n\n\n
<\/strong>My e-book, “Master Linux Commands”, is your essential guide to mastering the terminal. Get practical tips, real-world examples, and a bonus cheat sheet to keep by your side.<\/a>
Grab your copy now<\/a>.
VIP Community<\/strong>
If you just want to hang out with me and other Linux fans, you can also join the community. I share exclusive tutorials and behind-the-scenes content there. Premium members can also visit the website without ads.
More details here.
<\/a>
Need help building something with Python?<\/strong>
Python is a great language to get started with programming on any Linux computer.
Learn the essentials, step-by-step, without losing time understanding useless concepts.
Get the e-book now.<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"