Linkding

Linkding is a bookmarking tool. It has a UI similar to pinboard.in, can import bookmarks.html files, and has a decent API. It’s working very well. I’m particularly fond of the Linkding injector addon for Firefox, which injects Linkding search results into the sidebar of most popular search engines.

This one seems to be a keeper.

I briefly considered shaarli as an alternative. I didn’t like the UI as much, but it has a bigger list of third-party extensions than Linkding.

Wallabag

Wallabag is a self-hosted Pocket alternative. It also has a useful API, an iOS app, and a Firefox extension. I wasn’t too sure about this one going in, but once I got the Docker stuff and some reverse proxy weirdness sorted it worked quite well. It has a few more smarts than Pocket, and it provides Atom feeds of simplified articles you can use to create ebook digests via Calibre or just consume with your everyday RSS reader, given the formatting is cleaned up.

It also lets you share a public-facing version of a saved article, and its clipper extension seems to be able to see around a few paywalls if you’re saving from a subscription site.

I think this one is a keeper given I can automate the ebook exports: That essentially recreates the Pocket/Kobo integration.

calibre-web

calibre-web is a HTML5 front-end for Calibre libraries that allows you to edit metadata, organize your ebook collection into shelves and, most importantly to me, act as an online sync source for Kobo e-readers, allowing you to browse your collection and download to your Kobo, then keep your reading location in sync.

Some people live in calibre-web full-time, uploading ebooks and managing their metadata. I prefer to pair it with Calibre itself due to an ongoing content conversion project.

It’s definitely a keeper. I recovered a ton of books from another device and converted them to Kobo-friendly epubs. Better yet, when downloaded to a Kobo, calibre-web serves up kepubs, which are optimized for Kobos.

Calibre

Calibre is an ebook conversion/management tool, ordinarily used on the desktop. I found a Docker recipe that lets me run it on my Synology and access it via a web-based VNC tool. With a little fiddling, I added mountpoints that let me install downloaded extensions and import books from a bookdrop directory as I pull them down from their assorted vendor sites.

It works alongside calibre-web, allowing me to install books from assorted formats and export them to epub, where they’re almost instantly available from the calibre-web web interface or Kobo integration.

Even if sync didn’t work, you can access a content server that uses the OPDS protocol for browsing. So with a reverse proxy and authenticated user, you can get at your library from anywhere and side-load books to your reader.

I’m going to keep the Dockerized version.

Vikunja

Vikunja is a todo app that includes a traditional list view and a card view. It serves up CalDAV, so it could theoretically work with any CalDAV client, but its doesn’t work well with iOS Reminders. The responsive Web UI isn’t bad if you want to install it to your iPhone desktop.

I installed it and tried it for a day, but I am not sure about it. I’m a little uneasy about self-hosting my todos, and was hoping for some kind of native client.

Joplin

Joplin is an Evernote-esque app with a ton of cross-platform support that I couldn’t quite bring myself to trust in a self-hosted context. It’s a good tool and all, but I’d prefer to just have my notes in a plaintext, version-controlled setup.

MariusHosting

MariusHosting isn’t an app, it’s a site run by Marius Lixandru with a ton of recipes for Dockerizing common self-hosted apps on a Synology. It’s my first stop when I want to try something out. I was resistant to a lot of his earlier stuff because he had an idiosyncratic way of getting containers set up, but he has since begun to use Portainer for his recipes, which has simplified them a lot. If you find a Docker recipe that uses docker run, you can convert that to Docker Compose with composerize.

I can make do with just about any RSS service provided it:

• Has a clean web UI
• Allows third-party clients (e.g. Reeder, Unread)
• Has some sort of provisioning for filtering.

There are plenty that do the first two. That last requirement is a little harder, and it’s why I’ve largely stuck with Feedly despite a small break, when their management team demonstrated some bad ideas they eventually walked back.

But I’ve been on this self-hosting kick, and I learned about FreshRSS while I was poking around with PikaPods, so after a quick OPML export of my Feedly list and a little experimentation I’ve moved FreshRSS into the Synology:

• Clean web UI with keyboard shortcuts
• Extensions framework
• Sharing configuration
• Works with Reeder

The filtering works a couple of ways:

You can set up a “mark as read” filter with a simple syntax that includes operators like inurl, intitle, and keyword. That will handle new articles as they come in. That’s the best option if you’re using a client.

You can also use those operators in the web UI’s search field then save them and apply them to current articles just to clean up the view. That’s okay for cleaning up your current view before your filters start working on new stuff, or if you want to be able to create a one-click way to narrow a feed.

And your saved queries can also be referenced with the search:QUERYNAME operator, so if you model one out and like it you can make it more proactive.

You can guess what I don’t care to read about from The Oregonian based on my initial list:

inurl:/advice/
inurl:/ducks/
inurl:/betting/
inurl:/nfl/
inurl:/beavers/

Give it time and it will grow. I’ve only been using FreshRSS for a couple of days, so I haven’t had time to be exposed to everything, like the many, many, many articles that landed in the /casino/ section between starting this draft over breakfast and coming back to wind things down after dinner, making wish The O would do like other newspapers do and segment its RSS feeds at least into the major sections.

As it is, they don’t do that, and have a wildly flat and very granular IA, so you can’t just filter out inurl:/sports/ in one go, but at least they have reliable category URLs. At some point I will have to do the work of filtering out deal posts from all the tech sites, who are not at all incentivized to make it easier to avoid their affiliate link farming. Feedly has some sort of “AI” that creates meta-categories to filter on, so I could just tell it “no deal posts” and clean up a few edge cases.

I did look at a few others. TinyTinyRSS was a prime candidate, and even has a native Synology package. Performance wasn’t great, though. A few others had no filtering.

Kitty and the Synology

Also on the topic of the Synology, if anyone has gotten kitty’s advanced features working with one I would love a guide or insight into how. The environment is just a tad too locked down and non-standard, and a recent skim down a GitHub issue suggested that there’s not a lot of hope on that front. You can get as far as the Syno understanding that there’s such a $TERM as xterm-kitty, but the stuff like kitten ssh has been a lost cause. Or rather, I am was running out of patience with it because there’s a lot of magic on the happy path and then it gets pretty manual if you have to go off-road, and this is a Linux-based appliance we are trying to get this thing wedged onto, not some plain old box.

I changed that to was because I found this thread and it helped me figure out the small step I needed to take to get kitty working with my root account on the Syno.

And what a thread. It ends with the maintainer saying:

In any case, as I have explained before, if you want to perpetually stagnate the terminal ecosystem by insisting every terminal be xterm (the biggest boat anchor on the entire ecosystem), please just use xterm. kitty is not for you.

I kinda get where he’s coming from by the time the whole thing is over: Open source project owners are all over the map in terms of their approach to community interactions and management. Just yesterday I saw one who pleaded with a user who’d decided to just go use another app to share some sort of exit feedback. People in this thread were doing the whole “if this isn’t addressed I will try something else” thing that I imagine gets pretty grating if you’re just some person making a thing and giving it away and are over whatever things in the ecosystem you are over. Like, there are a lot of projects devoted to strict compliance with What Has Come Before, and I don’t think the *nix world has any shortage of adherence to What Has Come Before.

Anyhow, I usually don’t do anything particularly complex over on the Syno, but I was having issues with tab completion, backspace, and command history going screwy whenever I was operating as root so it seemed worth fixing to just keep using kitty and not remember to use another terminal app for this particular hobby.

E-readers vs. Tablets

Jason Snell on eink e-readers vs. tablets.

I’ve been through the “maybe I want to just consolidate down into an iPad mini” thing with my assorted e-ink devices, and I always come back to “the reading experience is worse on a tablet.” I’ve been back and forth on which ecosystem, too, and will stick with Kobo, less as a features thing and more as a “it’s hard to be rid of Amazon but I can at least be less into Amazon” thing.

The not-Nook/Kobo/Amazon space is interesting. I don’t know if I am up to being that much of a resister to Big Ebook. I have a little Onyx Boox Palma and super wanted to like it, but it’s just an e-ink Android tablet about the size of a “Max”-sized iPhone, and the e-ink/Android app experience with Kobo wasn’t very good. There are other reading apps for it, but I don’t know how location sync works in that ecosystem. Now that I have calibre-web set up I could get my books into anything, but I’m being way too much of a perfectionist on questions like “but what if I leave my e-reader behind and just want to use my phone for the train ride downtown” or whatever.

On the flipside, there are some very good e-reader apps for Android that can talk to calibre-web in OPDS mode. You don’t get the location sync stuff – it’s just a way to browse and retrieve your books – but if you can upload an epub to calibre-web it can come back down to a bunch of these apps, some of which do have for-pay location sync backends as an app feature.

Kinda academic right now: I have a nice and relatively new Kobo, I have a slightly more worn out but functional old Kobo, and I have them talking to my calibre-web install plus access to the Kobo store, Overdrive, and my Pocket articles. I don’t need to go out and buy another e-reader just to be a little more indy.

Well, after a lot of hinting and oblique mentions, it’s okay to finally say I started a new job this week, as director of IT at Iterable, thus ending about seven months of rest and a relatively easy job search.

Here’s the LinkedIn version:

I remember being 1200 feet over a Ft. Benning drop zone: My parachute risers had twisted up, my helmet had fallen off, and I was airsick. I thought to myself, “well, you brought this on yourself.”

Years and years later, I read Pema Chödrön, who said, “to be fully alive, fully human, and completely awake is to be continually thrown out of the nest.”

I finished my first day at Iterable today. I’m very happy to be starting this new role with a warm, welcoming team that includes a few familiar faces.

Reflecting on my time off after Puppet:

It is easier said than done to go still, rest, and find some quiet. I think I lost two months to assorted writing and photography projects and other busy-making stuff until someone close to me finally said, “I thought you were supposed to be resting. This doesn’t seem like resting.”

I did finally manage to go still and rest. When I decided to start looking for work again, I knew I had to sift through 10 amazing years at Puppet and figure out when I was happiest and helping the most people. Having the time to discern meant I was able to set a few things aside I would have sworn I most wanted to do as I realized I was probably just trying to replace something I’d lost. I felt more focused with each recruiter screen or interview, and my list of job alerts got shorter as I shifted from “what can I do” to “what do I want to do.”

It’s easy to euphemize: During my time out I got a lot of really unfortunate advice about covering up gaps, and trying to talk around things, so I’ll just say that yes, it sucked to get laid off — to get thrown out of the nest.

It wasn’t a world-ending shock, I was treated with respect and generosity, and it was a genuine gift to know that I could spend a few months helping my team transition once I knew I wasn’t going to continue. But it was still tough. So I’m also grateful to friends I got to spend time with over the past several months. There were a few times I felt at sea and unsure of myself, and all the coffees, lunches, and texts helped so much. I had a lot more friends on this jump than I did over that drop zone, and I’m very grateful for all of them.

There is a ton more to say about the past seven months, and it feels like the right thing to do is to think more deeply about big themes. But there are some little things to say:

First, I caught a lot of great breaks going into my time off, and saw my layoff coming far enough out that I could prepare. I spent a lot of my early career under the shadow of layoffs, with a completely different mindset. I think the person who smiled and told his layer-offer that he hoped they had an okay time with all their other layoffs last August would be completely alien to the person who wouldn’t take a weekend off for nine straight months in 2001.

There are lots of ways you can “figure out what’s next” that don’t have to involve getting laid off or quitting your job, but “figuring out what’s next” takes work. It’s probably easiest if you know and start acting on it while you have a job, but if you’re in a place where you have a ton of things to sort out and you’re just enervated from keeping the lights on wherever you are, it’s still kind of hard. I’m glad I had the resources, and hence the time, to take a break and be methodical. There was risk and some anxiety, but it got the best result.

Second, depending on how you want to manage the reckoning, this is my first new job in almost 11 years. I did so much growing during that time. There are some moments I wish I could go back to and get a do-over on, but that’s part of the whole “growth” thing … not getting things quite right the first time you encounter them.

Third, I’m glad I structured the job search the way I did. During the intense “cold call” period of February through April I had a loose routine of taking three days a week to just go through job listings and two days a week of applying for the listings I had saved the other three days of the week. Breaking it up like that gave me space to think about each listing.

I learned a practice years ago of pausing and asking if an opportunity or request elicits a “whole body yes,” — positive reactions from head, heart, and gut. I found that spending some time looking through job posts and quickly capturing the ones where my first response was “sure, I could do that,” then coming back to them a few days later to look a second time elicited a slightly different response. Sometimes it was “wow, why am I delaying the application here?” and other times it was “I don’t know why I thought that was a good idea.” The third test was the actual application — filling out whatever forms and writing a cover letter, and that was when I could tell whether my heart was really in it. If I couldn’t write a compelling cover letter — didn’t feel sincere or engaged — it was a signal from head and heart.

I started out looking at several kinds of jobs — IT, engineering, operations — and then a few categories within each. I had some good early signal from the operational roles (chief of staff and similar), extremely positive signal on IT, and really uneven signal on engineering. I was also looking at organizational size/maturity. Part of me went in thinking “man, I wish I could do a ‘Puppet in 2012, but everything I know now.’”

Going in my enthusiasm and interest was highest around chief of staff roles. Over my time at Puppet I’d been in and out of “operational leader” roles, and had to very disappointing experiences in that area. I wanted another bite at the apple. I got several interviews for that sort of thing, made it pretty far into a few processes, and came away with a few observations:

• The places where I would do the most good, that seemed the most exciting, and that were the most greenfield, were the worst conversations, and they happened early enough that my energy and patience for yet another baby CTO with a reflexive hatred for process were too low to even attempt to make a sale. Or they didn’t actually want a chief of staff — they wanted an EA/office manager.
• The places where I could be helpful and effective — the medium maturity organizations with enough introspection to know they needed help — were harder to find, and the few conversations I had there always left me uneasy. Like I was swapping the process resistance and insecurity of baby C-levels for the conditioned wariness of leadership teams that understand a chief of staff is a potential threat to the balance of power and their individual access and influence.
• There was a third tier – medium or high maturity orgs who wanted someone very senior with much more hard-core business operations experience. Just isn’t me, and I didn’t bother.

But I also had to come to grips with why I was looking at those roles to begin with, and it began to dawn on me that the things that made me a likely candidate to do that kind of thing at Puppet over the years involved a different mix of factors from what these places needed. I kept imagining doing these roles from the perspective of the person who’d been at Puppet for ten years, had a solid network, had a basis for trust with people throughout the business, and an inventory of patterns we could pick up and dust off that had the ring of familiarity for the old-timers, but could be pivoted or spruced up a little for the skeptical newcomers.

I kept saving those roles when I got job alerts for them, though, kept applying, and kept tracking why I dropped out or decided not to finish the cover letters for everything, and finally formed a thought over my morning tea and listing review one morning:

“You loved that place, loved being there, and loved even the people who drove you a little crazy. You wanted to make it better and knew how to get things unstuck. You understood what it needed on some emotional level. It’s gone.”

I quietly re-branded my LinkedIn page, turned off those job alerts, and narrowed my list to IT and engineering.

Engineering things weren’t sparking much joy at any point in the process. One opportunity came along that seemed interesting, but in a very “you’ve got a very painful-sounding definition ‘interesting’” sort of way. When you send your wife this gif to explain why you think you’d be a good fit for a job:

… you should ask a second time if that’s how you want to spend your days.

It kept coming back to which zone I’m in when I’m leading in engineering, and I never really felt like I was in my “Zone of Genius.” I’ve been around those people and know enough to understand the difference between us.

Ultimately the things that kept feeling the most right to me were the IT roles. I had a few processes go pretty far, so I had the chance to do a lot of personal writing and preparation, and I realized that the challenge I was having was less about thinking up a response, but organizing all the thoughts I had on any given part of the conversation. Over the course 30+ years in professional workplaces I held a lot of jobs in a lot of different kinds of businesses. I was never quite sure what skills would transfer in each role I held, but I knew that during my time in IT it felt I could tap the most of my experiences, and that my particular temperament worked the best.

By the time the Iterable opportunity presented itself, I felt primed and very clear.

I guess the last thing I want to say right now is that it was a pretty great couple of weeks of interviewing. I had no problem writing the customary followup note. The opportunity is at that intersection of “oh, there’s a lot to do” and “I know what I need to do.” I want to be there.

Our world of note-taking compromises

So part of Week One was having my new boss up from California for a kickoff and planning. We got a WeWork space. I didn’t do anything to get a toolchain onto my new work laptop so I didn’t have Emacs or any of my personal config stuff on it. It was a good opportunity to think about the compromises that have loomed the largest when it comes to living in the Emacs ecosystem but having the occasional mobile use case:

• Decent clients to read org-mode files.
• Reliable sync.
• Capture on the go.

After a few days in a WeWork, seeing what would have been useful and how I was working by just putting stuff in native tools then moving them over, I realized I’d be happiest working with these assumptions:

• Stick with Emacs/org-mode/Denote. They feel the best for just doing work on a laptop or desktop, and that’s where I do most of my work.
• Give up on any of the mobile options for managing org-mode. They’re dancing bears. It’s great that they can dance, and it feels uncharitable to complain that they don’t dance well, but they’re hindered by a lack of native sync. The best they can do is capture simple things and relate simple things. Put more weight on them and they’ll frustrate me.
• Make static notes available in a way that’s easily readable by native tools and put extra effort into making sure that when the static notes are pushed out, they’re truly pushed out.

On that last point, the biggest pain point I’ve come across using Denote/Emacs has been getting at stuff for reference when I’m not near a real computer. One way tools like Obsidian and Things run rings around Emacs is in their native, bespoke, purpose-built sync capabilities. Capture is no big deal.

Yesterday I spent some time sussing out how org-publish works and:

• Got my notes set up to publish using SimpleCSS.
• Connected the output directory to my Synology via SyncThing.
• Set up the Synology’s web server (it’s just nginx).
• I can connect to the saved notes via Tailscale, which is running on all my devices (and using NextDNS, which is sweet, since I was able to take out a whole layer of browser-based ad-blockers).
• Set up an after-save-hook to kick off a publish whenever I save a file in the notes directory.
• Set up a pre-save hook to update any Denote org-babel d-blocks, because I make meta note pages with those.

I put SyncThing on an aggressive update schedule to make sure the HTML versions of notes will get pushed out after saves.

Today I started figuring out how to add search to my exported notes. FuseJs seems to be working fine for that. I made a script that can walk the exported HTML notes and get them into a JSON index, and I added some HTML/JS to an index.org file in my notes directory. Here’s a quick demo of a few searches on mobile:

For now the notes indexing script is just running from the Synology’s Task Scheduler.

So, net:

• When I write or edit a note in Denote, save-hooks publish all my notes as HTML.
• SyncThing makes sure the HTML is pushed over to my Synology.
• The Synology periodically indexes the HTML for search.
• nginx running on the Synology serves the notes.
• Everything is happening over Tailscale.

There’s a very fair question, which is “why on Earth do all this when Obsidian, Logseq, or a few other mobile-capable PKMs are sitting right there?”

I guess the answer is, “I don’t like them as much.”

I mean, they’re fine and all — I would use Obsidian if there were no Emacs — but if I line up what they excel at with what Emacs/org-mode/Denote excel at, and ask myself “how do I most often use these tools,” the mobile access use case is relatively rare and mainly amounts to a question of access and very simple capture. I just want to know that if I save a piece of information on a laptop or desktop, it’ll be there for review on a tablet or phone not long after.

For a few hours of work configuring some off-the-shelf tools and a little bit of fine-tuning of the underlying sync engine, all my notes are securely available to me with super-fast search, and I can author them in a decent environment to begin with, not some Electron-based Markdown editor

I’m happy to share what I came up with but avoided my customary “here’s a few snippets.” The stuff I have going right now feels alpha. It’s working, but it’s in that realm of “I just got ping.” The HTML output needs some polishing, I’m not sure the search stuff is configured as well as it could, and it remains to be seen how it all works as I just get on with my day. I did as much as I could over a few sessions on the weekend so I could just get back to work tomorrow without any lingering “just one more thing” desire to fiddle.