Package: magpie
magpie: [ma]rkdown, [g]it, [pie]thonGit-backed Evernote replacementQuickstartPre-requisites(outside of PyPI):Python 2.7Pip/Easy InstallGitlibmagic(OS X specific issue; it’s already installed on most Linux
distros)cygwin (Windows only requirement; seeissue #4)Installing magpieIf you’re a Python person, and you are using virtual environments, just:pip install magpieIf you don’t know what Python virtual environments are:sudo pip install magpieSetup Git Repogit initLocally:mkdir -p /path/to/notes/repo/
cd /path/to/notes/repo/
git initOnGithubOnBitbucketgit configDepending on what your environment is like, you may get a nasty error the first
time you try to do something useful. This happened to me when I setup magpie to
work with supervisor. In order to resolve this, I had to set theuser.nameanduser.emailfields in git config. The error message on the magpie page
will tell you the syntax.Launch magpieIn a Python virtualenv:magpieIf you installed magpie withsudo:sudo magpieConnectIn browser, go tohttp://localhost:8080ConfigureOn the main page, there should be a link to configure magpie. (Alternatively,http://localhost:8080/config)Enter as much info here as you want. Username / Password are not required, but
recommended. The only required field is repo. The path from “Init Git Repo”
above should be entered here.Home Dir ConfigAs of version 0.0.4, if you have a “.magpie” directory in your home directory,
you can store config files there, instead of the default path. You’ll need to
make this directory after installing magpie and before running it.
Alternatively, you can create the directory and move the config files there
manually.Useful Linksmagpie documentationmagpie on Githubmagpie in PyPImagpie blogmagpie mailing listContributingTo DoWhat is magpie?IloveEvernote, but I no longer trust my data to cloud providers. Magpie
is an attempt to make a reasonably sufficient Evernote replacement where the
users control their data.Basically, magpie is just a web tool for managing text files in a git repo. In
it, you can create notebooks (which are just folders); create, edit, and delete
notes (which are just files). That’s pretty much it. However, when you make any
of these changes, they are automatically committed to git.DemoA demo of magpie is available here(If you make changes and they disappear, it’s because the demo resets itself
every 15 minutes.)What isn’t magpie?Complete (seecontributing)Secure (magpie is only as safe as you make it. If your git repo is hosted on
a public server, people will be able to read your notes. If you run it on an
open network, people may be able to access your notes. Etc.)Shiny (This is a side project written and maintained - so far - by a single
person. It’s never going to be as good or as useable as Evernote.)FeaturesMarkdown & HTML notes are rendered on the pageUses git as a backendEasy backups (if you know git): clone once, then push/pull to backup notestrack history, etc, just like with git (using git, not via magpie’s web
interface … yet?)Render “[ ]” and “[x]” as check boxes. Clicking them changes and saves the
note.Email yourself notes (seeemailing notes)Scrape PDFs to make them searchable in magpie (seepdf_scraper)Image AttributionLogo/favicon courtesy ofKieran Palmer, as licensed under CC BY-SA 2.0 Generic.