Today's Deep-Dive: Shiori
Ep. 177

Today's Deep-Dive: Shiori

Episode description

The deep dive explores the challenges of managing the overwhelming amount of online content and introduces Shiori, a simple bookmark manager designed to help users organize their links effectively. Developed in Go, Shiori is likened to a self-hosted version of Pocket, offering users more control over their saved content. It is easy to set up, as it comes as a single binary file, eliminating complex installation processes. Users can manage bookmarks through a user-friendly web interface, with essential features such as adding, editing, deleting, and searching for links.

Shiori also allows users to import existing bookmarks from standard formats and even from Pocket, ensuring they don’t lose previous collections. A standout feature is its offline archiving capability, which saves the actual content of web pages, protecting users from link rot. The tool is open source and has strong community support, indicated by over 10,000 stars on GitHub and active development. Overall, Shiori presents itself as an accessible and reliable option for anyone looking to manage and preserve their online finds effectively.

Download transcript (.srt)
0:00

Welcome to the deep dive, let's jump straight in today.

0:03

We're talking about something

0:04

I know affects pretty much everyone online.

0:06

It's that feeling, right?

0:07

The sheer flood of links, articles,

0:09

just stuff you find online every single day.

0:12

How do you keep track of it all

0:14

without losing your mind?

0:16

Now this deep dive is supported by Safe Server.

0:19

They handle hosting software

0:20

and can really help support your digital transformation.

0:23

You can find out more at www.safeserver.de.

0:28

So a big thanks to Safe Server for making this possible.

0:31

And today, yeah, the source material we're diving into

0:35

looks at a tool that's actually built

0:36

to tackle that exact problem.

0:38

It's a specific kind of bookmark manager

0:40

and the sources suggest it's, well, refreshingly simple.

0:43

A bookmark manager.

0:45

Okay, but I mean, my browser does that already.

0:47

Why would I need something else?

0:49

I'm really interested to unpack this

0:50

based on the source material.

0:52

What is this thing and why would it be useful?

0:54

Especially maybe for someone feeling a bit buried

0:57

or just starting to think about organizing their online finds,

1:00

is it actually easy to start with?

1:01

That's exactly the angle.

1:03

The source material introduces a tool called Shiori

1:06

and it's described pretty clearly,

1:08

a simple bookmark manager built using the Go language.

1:11

Simple. Okay, I like the sound of simple,

1:13

especially when you're drowning in links.

1:15

The material even compares it to pocket

1:17

saying it's meant to be like a simple clone.

1:18

A lot of you probably know pocket, right,

1:20

for saving articles.

1:21

So thinking of Shiori like your own personal,

1:24

self-hosted pocket,

1:26

that gives a pretty good idea, saving things,

1:28

but maybe with more control.

1:29

Precisely. And one thing the source really emphasizes,

1:34

especially for ease of use and getting started,

1:36

is how it's distributed.

1:37

It comes as a single binary.

1:39

A single binary. Okay.

1:40

So for someone, maybe not super technical,

1:43

what does that actually mean,

1:44

practically speaking, how's that easier?

1:46

Well, it often just means you download one single file.

1:48

That file is the program.

1:50

No complex setup wizards,

1:52

no chasing down other bits of software it needs to run,

1:54

makes it really portable, really straightforward,

1:57

to just get going on your own machine,

1:59

or maybe a small server.

2:02

Just one file. Okay.

2:04

That does sound less intimidating than the usual install process

2:08

that fits the easy entry idea.

2:10

Right. While it's not something you need to fuss about right away,

2:13

the source does mention it's flexible underneath.

2:16

It supports different kinds of databases like Sklite 3,

2:19

PostgreSQL, MariaDB,

2:22

MySQL for actually storing your bookmarks.

2:24

Databases. Okay, that sounds technical again.

2:27

Well, yeah, but for beginners,

2:28

the default Sklite 3 usually just works out of the box.

2:31

No setup needed really.

2:33

The others are just options,

2:35

good options if your collection gets huge,

2:37

or you have specific needs later on,

2:38

so it gives you choices but doesn't

2:40

force complexity on you right at the start.

2:42

Got it. Simple start, power later if you need it. Makes sense.

2:45

Once you've got the single file running,

2:48

how do you actually use it day-to-day?

2:50

What does the source say?

2:51

It outlines two main ways basically.

2:53

You can use it from the command line,

2:54

which is powerful, sure,

2:56

but maybe not the first stop for everyone,

2:58

or, and this is probably key for most people,

3:00

you can use it as a web application.

3:02

The web app. That sounds like the way in.

3:05

The source calls the interface simple and pretty.

3:09

That's definitely the route I'd take.

3:10

Just open it in your browser and presumably,

3:13

all your saved stuff is just there, ready to manage.

3:17

Exactly that. That web interface

3:19

is really central to making it approachable.

3:21

Okay, so managing, what features does the source highlight

3:25

for actually using the links you save?

3:27

I assume the basics are covered.

3:29

Adding, editing, deleting, searching.

3:32

You need those just to keep things usable.

3:34

Absolutely. Those core functions are there.

3:36

But what if you're not starting from zero?

3:38

What if you have like hundreds of bookmarks

3:40

already somewhere else?

3:41

The source tackles that. It mentions import features.

3:44

You can import from that standard Netscape bookmark format.

3:47

Most browsers can export that.

3:49

And you can even import directly from Pocket

3:51

if you've been using that.

3:52

Oh, that's important.

3:53

And crucially, it also lets you export your data back out.

3:56

Right. So you're not starting over

3:57

and you're not trapped either.

3:59

You can bring your stuff in and take it with you

4:00

if you ever decide to switch.

4:02

Okay.

4:02

Well, that's reassuring actually.

4:05

Okay. Now here's something the source mentions

4:07

that sounds, well, really interesting.

4:10

The offline archive feature.

4:11

It says, where possible,

4:14

Shiori parses the readable content

4:17

and makes an offline archive.

4:19

What does that really mean?

4:20

Why is that better than just saving the link?

4:23

What does it protect you from?

4:25

This is a really key difference.

4:27

It's not just saving the web address, the URL.

4:30

Shiori tries to actually download

4:32

and save the content of the page,

4:34

the article text, the main information.

4:36

Think of it like taking a permanent snapshot.

4:39

Ah, okay.

4:40

The source points out that this means

4:41

even if the original website changes that page later,

4:44

or maybe even takes it down completely,

4:46

your saved copy of the content should still be there,

4:49

safe inside Shiori.

4:50

Wow.

4:51

It's basically a way to fight against link rot,

4:52

you know, when links just die over time.

4:54

Yeah, happens all the time.

4:55

So this helps you build a more durable personal library

4:59

of the web stuff you actually care about.

5:01

That feels significant,

5:02

like future-proofing your saved knowledge.

5:05

Browser bookmarks definitely don't do that.

5:07

If the page is gone, the bookmark's useless.

5:10

That solves a really common frustration that's powerful.

5:13

It really shifts things from just pointing to a page

5:16

to actually preserving it.

5:17

And to make the saving part easy,

5:19

the source also mentions there's beta support

5:21

for browser extensions for Firefox and Chrome.

5:24

So you can just click a button in your browser

5:26

while you're reading something

5:27

and save it directly to Shiori.

5:29

Integrates right into how you normally find stuff.

5:32

Okay, let's recap.

5:33

It sounds simple to get started.

5:34

Single file, nice web interface.

5:36

It lets you bring in your old bookmarks,

5:38

make saving new ones easy with extensions.

5:40

And it has that really standout offline archiving

5:43

to stop links from dying.

5:45

But how reliable is this?

5:47

Is it some little side project that might vanish?

5:50

How do you know you can trust it with all this saved stuff?

5:53

That's a fair question.

5:54

The source gives a couple of good indicators here.

5:56

First, the license.

5:57

It's under the MIT license, which means it's open source.

6:01

Okay, open source.

6:02

So the code's out there for people to see.

6:03

Exactly.

6:04

It's free to use, free to modify.

6:06

And that openness usually encourages a community

6:08

to build around it.

6:09

Right, more eyes on it.

6:10

People fixing bugs, adding things.

6:12

Precisely.

6:13

And the source provides some numbers

6:15

that suggest the community is quite active.

6:17

It mentions over 10,000 stars on GitHub.

6:20

That's like a thumbs up from developers.

6:22

Nearly 600 forks, meaning people are copying the code

6:25

to work on it.

6:27

And 64 contributors.

6:28

10,000 stars.

6:30

Yeah, that's not small.

6:31

No, those numbers suggest it's pretty popular,

6:34

actively developed, and well supported.

6:36

It points towards it being a reliable choice,

6:38

not just a flash in the pan.

6:40

Okay, so putting it all together.

6:41

Shiori, based on what the source material tells us,

6:43

seems like a really accessible option.

6:45

It's simple, it's portable,

6:47

that single binary thing is key,

6:48

it's got a friendly web interface,

6:50

tackles real problems like getting your old blinks in,

6:52

and crucially, that offline archiving.

6:55

And it's backed by a healthy open source community.

6:58

Sounds like a solid starting point

7:00

for anyone wanting to finally get a grip on all those links.

7:03

I think that's a fair summary based on the source, yeah.

7:05

It presents itself as a straightforward way

7:07

to take control.

7:08

Makes it easier, especially for beginners,

7:10

to start saving, organizing, and importantly,

7:13

preserving the web content they value

7:15

without the later frustration of finding it gone.

7:18

So maybe something for you, the listener,

7:19

to think about as you're browsing later today.

7:22

How much do you actually value having

7:24

your own personal accessible copies of the web

7:26

pages that really matter?

7:28

Copies that stick around no matter

7:30

what happens to the original site online.

7:32

Worth considering.

7:34

And let's give one final thank you to Safe Server

7:36

for supporting this deep dive.

7:38

Remember, Safe Server helps with hosting software

7:40

Check them out at www.safeserver.de.

7:40

Check them out at www.safeserver.de.