From c2bffc09ce0fea206d17ae2613a7d9cd98965c3b Mon Sep 17 00:00:00 2001 From: NunoSempere Date: Fri, 12 May 2023 00:55:52 -0400 Subject: tweak: give some love to the README. --- README.md | 101 +++++++++++++++++++++++++++++++++++++++----------------------- 1 file changed, 63 insertions(+), 38 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 99fe6a6..a3be111 100644 --- a/README.md +++ b/README.md @@ -1,58 +1,93 @@ ## Rosenrot -A small browser forked from [rose](https://github.com/mini-rose/rose). +Rosenrot is a small browser forked from an earlier version of [rose](https://github.com/mini-rose/rose), with some additional quality of life improvements tailored to my (@NunoSempere) tastes and setup, and with detailed installation instructions for Ubuntu 20.04. -- Rose is a minimal browser based on webkit2gtk which aims to be a "basement for creating your own browser using [the] gtk and webkit libraries". -- Rosenrot is my fork from rose. It has accumulated quality of life features/cruft that I like, like a "readability" plugin that simplifies annoying websites like [Matt Levine's Money Stuff newsletter](https://www.bloomberg.com/opinion/articles/2022-10-18/matt-levine-s-money-stuff-credit-suisse-was-a-reverse-meme-stock). It also incorporates ad-blocking. -- Rosenrot is also a song by the German hardcore rock band [Rammstein](https://www.youtube.com/watch?v=af59U2BRRAU). - -You can see some screenshots in the [screenshots](./screenshots) folder. - -### Features - -- tabs, cookies, caching -- minimal ui, autohiding elements -- ~467L core code (the rose.c file) -- custom gtk and websites css -- builtin rose-mklink script for in-shell static links -- A few quality of life improvements. - - Optional adblocking through [wyebadblock](https://github.com/jun7/wyebadblock) - - Plugin system: - - Libre redirect: Redirect annoying websites to open source frontends - - Readability: Strip webpages of unnecessary elements for ease of reading with a custom shortcut - - Custom style: Override the css of predetermined websites - - Stand in plugin: Mimick function definitions which do nothing for the above plugins so that they can be quickly removed +![](https://raw.githubusercontent.com/NunoSempere/rosenrot-browser/master/screenshots/6-hello-world.png) ### Installation -Install dependencies, then: +You can see detailed instructions [here](./user-scripts/ubuntu-20.04/install-with-dependencies.sh), for Ubuntu 20.04 in particular—though they should generalize trivially. Or a video installing rosenrot in a fresh Ubuntu 20.04 virtual machine [here](https://video.nunosempere.com/w/t3oAvJLPHTSAMViQ6zbwTV). + +The general steps are to install dependencies, and then ``` make build make install # or sudo make install ``` -You can also see more detailed instructions [here](./user-scripts/ubuntu-20.04/install-with-dependencies.sh), for Ubuntu 20.04 in particular—though they should generalize trivially. Or a video installing rosenrot in a fresh Ubuntu 20.04 virtual machine [here](https://video.nunosempere.com/w/t3oAvJLPHTSAMViQ6zbwTV). +### Usage + +After building: + +``` +./rose +``` + +After installing: + +``` +rose +``` + +You can also create a rose.desktop file so that it will show up in your desktop environment. You can see this documented [here](./user-scripts/ubuntu-20.04/install-with-dependencies.sh). + +### Features + +- Tabs, cookies, caching +- Minimal ui, autohiding elements +- ~464L core code (the rose.c file) +- Customize appearance of the browser through css +- Built-in rose-mklink script for in-shell static links +- Optional adblocking through [wyebadblock](https://github.com/jun7/wyebadblock) +- Plugin system, seeded with: + - Libre redirect: Redirect annoying websites to open source frontends + - Readability: Strip webpages of unnecessary elements for ease of reading with a custom shortcut + - Custom style: Override the css of predetermined websites + - Stand in plugin: Mimick function definitions which do nothing for the above plugins so that they can be quickly removed + +You can see some screenshots in the [screenshots](./screenshots) folder. + +## Relationship with [rose](https://github.com/mini-rose/rose) -### 👐 Contribute +- Rose is a minimal browser based on webkit2gtk. Previously, it described itself as aiming to be a "basement for creating your own browser using [the] gtk and webkit libraries". +- Rosenrot is my (@NunoSempere's) fork from rose. It has accumulated quality of life features/cruft that I like, like a "readability" plugin that simplifies annoying websites like [Matt Levine's Money Stuff newsletter](https://www.bloomberg.com/opinion/articles/2022-10-18/matt-levine-s-money-stuff-credit-suisse-was-a-reverse-meme-stock). It also incorporates ad-blocking. +- Rosenrot is also a song by the German hardcore rock band [Rammstein](https://www.youtube.com/watch?v=af59U2BRRAU). + +### Contribute - Contribute upstream to [github.com/mini-rose/rose](https://github.com/mini-rose/) for core functionality changes. - Contribute here for quality of life improvements, by sending a pull request on Github. +### Cool things + +I just found out that you can inspect a GTK application with the GTK explorer if you set a certain command-line variable. Try this with `make inspect`. + +### Known bugs/gotchas. + +- [ ] Doesn't work with when Spanish is selected as the language, for some reason. +- [ ] At some point, I tried to install libsoup-3 and borked some unknown installation option/paths. So now I need to run rose with `GIO_MODULE_DIR=/usr/lib/x86_64-linux-gnu/gio/modules/ /bin/rose` (or put `export GIO_MODULE_DIR=/usr/lib/x86_64-linux-gnu/gio/modules/` in my .bashrc). This won't affect new users though, just double checked on a fresh machine. +- [ ] By default the searchbar is pretty gigantic. I've made this so because I'm a bit myopic, but also work with my laptop in a laptop stand. Anyways, if you are a more normal person you can change this in the style.css. +- [ ] The style.css usage isn't updated until installation. This is because by default rose uses the theme located in /usr/share/themes/rose/style.css, and that file isn't updated until make install. + ### To do -- [ ] Look at using relative rather than absolute paths +#### Quality of life: - [ ] Add css for js alerts -- [ ] Figure out if downloading files is doable. - [ ] Figure out better way to have plugins - [ ] Double check newtab/next-tab behavior -- [ ] Find out what each of the css elements refers to. +- [ ] Document creating new applications, e.g., as in [Asana for Linux](https://git.nunosempere.com/NunoSempere/asana-for-linux) + +#### Maintenance - [ ] Use something other than Whatsapp as an example syslink. - [ ] Set [`webkit_web_context_set_sandbox_enabled`](), as recommended [here]() - [ ] Fix bug about distorted audio. Maybe related to [this pipewire issue]()? +- [ ] Upgrade to GTK-4 / Webkitgtk 6.0? Will take a fair amount of time, since these are not available on Ubuntu 20.04. -Done: +#### Previously done +- [x] Find out what each of the css elements refers to. => done, see make inspect +- [x] Figure out if downloading files is doable. => it is +- [x] Look at using relative rather than absolute paths for configuration. => now makefile is a bit smarter - [x] Streamline installation a bit - [x] Substitute paths in makefile - [x] Create cache directory automatically @@ -74,13 +109,3 @@ Done: - And for actually opening links with the href new_tab option. - Links: [1](), [2](), [3](), [4]() -## Cool things - -I just found out that you can inspect a GTK application with the GTK explorer if you set a certain command-line variable. Try this with `make inspect`. - -### Known bugs/gotchas. - -- [ ] Doesn't work with when Spanish is selected as the language, for some reason. -- [ ] At some point, I tried to install libsoup-3 and borked some unknown installation option/paths. So now I need to run rose with `GIO_MODULE_DIR=/usr/lib/x86_64-linux-gnu/gio/modules/ /bin/rose` (or put `export GIO_MODULE_DIR=/usr/lib/x86_64-linux-gnu/gio/modules/` in my .bashrc). This won't affect new users though, just double checked on a fresh machine. -- [ ] By default the searchbar is pretty gigantic. I've made this so because I'm a bit myopic, but also work with my laptop in a laptop stand. Anyways, if you are a more normal person you can change this in the style.css. -- [ ] The style.css usage isn't updated until installation. This is because by default rose uses the theme located in /usr/share/themes/rose/style.css, and that file isn't updated until make install. -- cgit v1.2.3