While I love the concept of TheBrain (I’ve been trying to use it since its first release I think) it never clicked with me. So I wrote a small python script to export all the thoughts and make them available as markdown files. Pretty rough, but it works.
The converted files will contain the title of the thought, any notes and links to attachments. Jumps, parents and children are put at the bottom of the note.
So yeah, a lot of (manual) work is to be done after importing this into Obsidian, but it’s a start.
Thanks, Sander. I’ve also been a TheBrain User since around 2008 (I think). Obsidian flipped me by creating such a frictionless way to stay in my content. TheBrain’s Plex feels like it’s focal point, rather than my content. In Obsidian, my notes get center stage while I can still use the graph view for thinking about connections.
I could use some help getting started with your python script. I’ve set up GitHub Desktop, installed CodeRunner, and downloaded your file, and updated the file paths. I get the following error:
Traceback (most recent call last):
File “thebrain2markdown.py”, line 3, in
import html2markdown
ImportError: No module named html2markdown
Can you help me work through this? Thanks, and no worries if I’m asking too much. No is an acceptable answer. I don’t know if it matters, but I’m on MacOS Catalina.
[added] I found and downloaded a .js html2markdown file from GitHub. I’m not sure if this is what is needed, but as you might have guessed it didn’t make a difference. As you can tell, I’m not a programmer, though I was 30 years ago. TIA.
I’m glad you asked, cause that way I can make the README a bit better. But I’ll answer your question here first.
Python needs certain modules (pieces of code written by others) to work. In this case html2markdown. The .js file you downloaded might be the same idea, but only for Javascript.
Since you’re on a Mac, you’ll need to install Python3 first (2.7 is installed by default). This guide can help with that:
After that, you install the module from a terminal with the command pip3 install html2markdown. Then run the script with python3 thebrain2markdown.py. If other modules are needed, you could install them the same way.
@Sander, Im on Windows 10 and have downloaded portable python (https://sourceforge.net/projects/portable-python/)
but have never used python.
Do I need to go and find the html2markup plugin to make your script work?
One week into Obsidian and I’m way over my head, but I dont care because I see it as the future.
I’m afraid I don’t know that distribution of Python. You need a command prompt to be able to install modules with pip. And I don’t see something like that in the screenshots. You could download one of the more official packages: https://www.python.org/downloads/windows/
OK, I was able to use the portable python install I referenced in windows 10, I successfully installed the html2markup plugin via the pip3 (it downloaded that and a couple other things). After that I executed the command and it errored out. I read some other threads about py scripts, and many ask you to put the script into the root of the folder structure it will act on, and then in python command window, cd over to that directory, and then execute the python3 etc line. Is that what I do with this? Do I put your thebrain2markdown.py into the root of THEBRAIN data structure? Then cd over to that in python?
here’s a screenshot of my trainwreck trying to use python, hahah. getting there. you see the html error, i thought i needed to migrate the script to the data folder. but of course-- now that you replied-- i realized i’m even dumber-- didn’t export to json first-- i read your instructions as ‘the script exports to json’ when in fact, obviously, it’s not the case. will do that, and try again. once i figure out how to use python and run one script, I’ll be able to access all the other wonderful py people have been writing, so, for me, I’m trying to teach myself to fish… thank you for your patience!
I right clicked on your hithub project page on the thebrain2markdown.py file, and selected ‘save as’. But I guess in chrome it saves as an html with your script inside there. So I went back and clicked on that file instead (on github), and the next page I clicked ‘raw’ in the top right, and now I see the code, starting with ‘import json’… So then I copy-and-pasted that into this editor:
OK, instead of changing the path variables to the absolute path of my desktop (that’s where i put thebrain exported json), I saved your script untouched, and instead moved the export folder to the relative path of the script itself, and called it ‘export’ as the script does. I then got this error:
That way every browser would download the webpage the link points to, not the Python file in this case. Only the raw option you used would work this way. Most of the times people use git to download stuff from Github, or the zip download option.
As for the error you get, I did a Google search on it (hint ) which pointed me here:
It’s a bit of an old post, but it might point you in the right direction.
OMG THANK YOU!!!
I have been using the Brain for years but have been frustrated with it’s limitations and also how it is completely proprietary and allows little modification of functionality.
However, I have built up a big beautiful database of complex interconnections in it and was afraid that if I wanted to switch to Obsidian I wouldn’t be able to port all the work I’ve done curating information and building associations into it.
Thanks for creating this tool. I was wondering if you had suggestions on what to do when I come up with the following error:
PS C:\Users\alvar\OneDrive\Desktop\TB-Obsidian> py thebrain2markdown.py
Traceback (most recent call last):
File "C:\Users\alvar\OneDrive\Desktop\TB-Obsidian\thebrain2markdown.py", line 110, in <module>
for line in io.open(internal_file):
FileNotFoundError: [Errno 2] No such file or directory: './export/4eef93c3-8901-4e33-abbc-94eeeb7a2399/Notes.md'
PS C:\Users\alvar\OneDrive\Desktop\TB-Obsidian>
Hm… it’s been a while since I used the script myself. So I’ll have to take a look. Does this happen with a test Brain as well? If so, could you please send that test Brain to me so I can test it as well?
Edit: just a silly thought: I noticed you use OneDrive. Could it be that OneDrive deletes local files to save space? I know iCloud on my Mac does it, even with smaller files. That way my script would loose track of it.
@Sander thanks for getting back to me;o I dn’t know why I didn’t receive message notification!
Well, I don’t have my Brain stored in OneDrive, it was just the export to JSON because my desktop is synced with OD. However, I’m going to try with a test brain and also test saving the export to another, unsynced folder!
Here we’re over a year later and I’m performing a similar migration. I appreciate the stepping stone. As you hint there are many brain fragments deal with - images and internal wiki-links. That’s life.
) which pointed me here: