Hi! My name is Michał Góral, I am software developer (currently at Nokia) and this is my personal website. You can read more about me on a separate page if you’re curious.

Changelog

Reading hurts

, .

Reading hurts because people (me included) don’t know how to write. We don’t cross out the wrong words. (sidenote: Mark Twain reference, at least according to Civilization 6.) If you don’t know how to keep attention of your readers, do everyone a favor, yourself included, and be concise. Go straight to the point and write 3-4 sentences instead of 3-4 paragraphs, because this is the most that people bear before losing interest. (sidenote: Too bad that schools teach the exact opposite of this idea.)

Paperless-ngx

, .

Yesterday I installed paperless-ngx for management of my family documents. It is very good. It took me some time to re-categorize everything, because I had hoped that its neural network would do most of the grunt work, but it didn’t. After some learning it tagged some of the documents (incorrectly) and didn’t touch most of them, so I had to resort to the ordinary word- and regex-based rules. I actually had fun writing these and they now do 90% of work for new documents.

I don’t have a scanner which can output to the network share, but I added the consume directory (sidenote: Paperless-ngx automatically fetches all new documents from it.) to Syncthing and it’s great!

Fish Completion

, .

It’s refreshing to use completion system in fish. Instead of gazillion scattered completion functions (like in Bash or ZSH), obscure manuals and unsearchable documents that only lead you to reverse engineering some online examples, fish has one command: complete. Just call it repeatedly for all possible arguments and you’re done. complete -h gives all the necessary details and online tutorial has many useful examples on top of it.

Fish

, .

On one laptop I encountered a strange slowdown in zsh: loading any completion script from a custom fpath, even an empty file, adds ~500 ms to the startup time. I’ve heard many good things about fish, so I decided that this might be good opportunity to give it a proper testing. (sidenote: I had tried it few times in the past, but not for long.) After few days, and this is incredibly fast for me, I think that I’ll stick with it. Few minor annoyances for me are:

  • I have some scripts which do something like ssh $SHELL -c ..., which fails if there’s no fish on remote system (there usually isn’t). I had to switch to SHELL=sh ssh $SHELL -c ...
  • I can’t get used to replacing oldschool backticks (for invoking subshell) with parentheses
  • ctrl-c doesn’t produce an empty prompt - this makes sense, but I have a muscle memory of doing it to produce a few empty lines of visual separation between commands.

I kinda love everything else (including startup speed), so it’s a win I guess.

Creations

Synchronization

I synchronize a lot of things, each of them differently. Let's take a look how to write a simple Bash script which automates and parallels that.

Generacja wersji [PL]

Presentation of simple scripts and techniques allowing automatic generation of program's version.

Working on TWC Formatting

Formatting is one of these parts of TWC which I disliked the most. This has finally changed with release of TWC 0.9 and complete rewrite of formatting strings syntax.

Dotfiles [PL]

-

Description of my old custom system of keeping and deploying dotfiles.

Commenter [PL]

Presentation of my program for toggling file comments depending on a list of keywords in a language similar to preprocesor.

Singleton w i3 [PL]

With markorapp, a script which I wrote, it's easy to create "singletons" in i3. Singletons are applications which should have only one instance, like a particular terminal.

Creations: Release Notes

kpsh 1.0

First stable release of kpsh

SubConvert 0.8.2 [PL]

I released a new version of SubConvert, a program to convert between various video subtitle formats.

Home Automation

Sysadmin

I Blocked Bots

-

Every month bots eat my server's traffic, so I blocked them.

Job Queue in GWS

Examples of using job queues in GWS to run a lightweight CI/CD

Software Design

Computer Tools

Polish Git

How to force Git to speak English.

Describe Merges!

-

Changelog is important, but we can simplify our lives and generate it, at least partially.

Kupfer [PL]

Kupfer is a program launcher written in Python.

Desktop Systems

State of Wayland [draft]

Current state of Wayland on desktop PCs, its quirks and workarounds

Xsession in Debian

Xsession is a default way of starting X sessions in Debian, but for some reason it remains a mystery for many people. Here I try to shed some light on it.

Git Credential Helper [PL]

Git has capabilities of writing custom credential helpers, which can fill passwords for accessing HTTP repos for us.

Zmiana monitorów w i3 [PL]

I did it! I forced a buggy xrandr to toggle screens and not kill X session!

C++

Najważniejszy const [PL]

There is one const usage in C++ which is a little different than the others. Andrei Alexandrescu called it the most important const.

std::move [draft]

-

A short introduction to one of the most breakthrough features of C++11: rvalue references and move semantics.

Zwracanie wartości z funkcji [PL]

The article about Return Value Optimization - one of the most important features of C++ compilers.

Structured Bindings [PL]

Structured Bindings is a new way to decompose values returned from functions. It's similar to some other programming languages and greatly simplifies the code.

Problem dependant names [PL]

How C++ handles dependant names and why we must use typename keyword everywhere.

Name hiding [PL]

Name hiding is a surprising feature of C++. Here we'll learn a little more about it.

Polimorfizm [PL]

Introduction to C++ polymorhpism.

Urbana meeting [PL]

A short summary of C++ comitee meeting in Urbana-Champaign.

Python

Conversion Descriptor

Clever descriptor which automatically converts assigned values to the annotated type.

Cleanup

Application cleanup in Python inspired by weakref finalizer objects

Timeout Anything

Writing a generic function for timing out blocking operations

Naughty Python

A short thing about how Python prints its version number.

Zamykanie aplikacji PyQt [PL]

Graceful shutdown of PyQt applications might be harder than it looks like. This article presents the problem and a way to resolve it.

Shells

Describing Switches

Practical tips for creating fish completions together with descriptions.

Process substitution [PL]

Process substitution in Bash is a powerful technique which allows us to redirect command's output to programs which only accept files.

Technology

Internet mobilny [PL]

Few quick thoughts about the mobile internet.

Computer Science

Matlab engine [PL]

-

How to use Matlab Engine in C++

Software Freedom

Doom 3 GPL

Doom 3 source code has been released.

Philosophy

Life is Creating

To live our lifes and not merely exist, we, the humanity, must create

Politics

Invasion

Yesterday Russia invaded Ukraine.

Your Pain Is Bigger Than Mine

Even though I almost entirely stopped listening to it, I can't stay silent about recent events in Polish Radio Trójka.

Books

Cosmere [draft]

-

Field notes about Cosmere.

Warbreaker

Review of Warbreaker by Brandon Sanderson

Reviews

Nikon D5300

-

First thoughts about the new camera

SDF

SDF is a public access UNIX System which I recommend visiting sometimes.

Android Apps [PL] [rework]

-

Reviews of some interesting Android Apps

Writing

Cross References in Notes

Notes should be pretty too, because why not? Here I'll show you my method of rendering them to HTML.

Notes on Notetaking

-

Some things which I have learned over the years of notetaking.

I Want a To-Do App

It seems that we have a curse of abundance: so many to-do apps and methodologies that we can no longer choose one.

Personal

Mice

Thoughts of new mice owner

Migadu [in progress]

Trying something new for mail provider: a small company from Switzerland called Migadu.

PrintScreen

A short story about a prank which I unknowingly did to myself.

Wishlist

-

Things which I wouldn't mind to receive

The Blackout

Yesterday early morning there was a blackout.

Personal: Site

Digital Garden

-

Default chronological order of posts on this blog might not be the best.

Sidenotes [draft]

Implementation of sidenotes/margin notes on this blog

10 years

10 years of blogging on my own.

Blog changes

Introduction of new blog theme: Tale.

New Year's resolution

It's a little late to make a New Year's resolution, but I'll make one nevertheless.

Hugo [PL]

Switching to another static site generator: Hugo.

Parenthood

I have forked

What is a fork() and what PID it returns?

Double fork

Here we will learn about so-called double fork technique... More-less.

First Drawing

Przemek's first drawing presenting his whole family.

Practical

Cursed [in progress]

-

Cursed knowledge I wish I didn't know

When I Die

-

What will happen when I die - a plan for my family

Photography

Niesulice

Niesulice is a small village over Niesłysz lake.