Summary Files Commits Branches @commit @diff @stats
path: root / README.md
diff options
context:
space:
mode:
Commit5a86c8d7f38140f7eb736c0d4665de19889aa908 (patch)
Author
 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
2019-03-15 17:44:36 +0100
Committer
 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
2019-03-15 17:44:36 +0100
Filesf1f1685b9ce92e800cf253d07c92492765058b7a /README.md
goodwolf-5a86c8d7f38140f7eb736c0d4665de19889aa908.tar
goodwolf-5a86c8d7f38140f7eb736c0d4665de19889aa908.tar.gz
goodwolf-5a86c8d7f38140f7eb736c0d4665de19889aa908.zip
Parentebfa85f2cfbd3770fae4f83d7457dcfb001b5fd1 (diff)
Parentdf88b7bba5aec2d776d637d4fde05a1e58e6595f (diff)
Merge branch 'develop' v0.1.0-rc.1
1 files changed, 26 insertions, 4 deletions
-rw-r--r--README.md30
diff --git a/README.md b/README.md
index d707444..0ac1779 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,41 @@
# BadWolf
Minimalist and privacy-oriented WebKitGTK+ browser
+```
Copyright © 2019 Haelwenn (lanodan) Monnier <contact@hacktivis.me>
SPDX-License-Identifier: BSD-3-Clause
+```
The name is a reference to BBC’s Doctor Who Tv serie, I took it simply because I wanted to have a specie in the name, like some other web browsers do, but doesn’t go into the “gentle” zone.
-Target: https://hacktivis.me/articles/www-client%20are%20broken
+## Differencies
+Comparing from other small WebKit browsers for unixes found in the wild:
+
+- Independent of environment, should just work if GTK and WebKitGTK does
+- Static UI, no element should be added at runtime, this is to avoid potential tracking via viewport changes
+- Small codebase, right now we are well under 1 000 lines
+- Does not use modal editing (from vi) as that was designed for editing, not browsing
+- UTF-8 encoding by default
+
+Motivation from other clients <https://hacktivis.me/articles/www-client%20are%20broken>
## Repositories
+### git
- Main: <https://hacktivis.me/git/badwolf/>, <git://hacktivis.me/git/badwolf.git>
- Mirror: <https://gitlab.com/lanodan/badWolf.git>, this one can also be used if you prefer tickets/PRs over emails
-## Dependencies
-- WebKitGTK+
-- GTK3+
+### release tarballs
+- Main: <https://hacktivis.me/releases/>
+- Mirror: <https://gitlab.com/lanodan/badWolf/tags>
+
+Files ending in `.sig` are OpenPGP signatures done with my [key](https://hacktivis.me/key.asc)(`DDC9 237C 14CF 6F4D D847 F6B3 90D9 3ACC FEFF 61AE`).
+
+## Manual Installation
+Dependencies are:
+- [WebKitGTK](https://webkitgtk.org/), only the latest stable will be fully supported
+- C99+ Compiler (such as clang or gcc)
+- POSIX make (works with GNU or BSD)
+
+Compilation is done with `make`, install with `make install`.
## Notes
Most of the privacy/security stuff will be done with patches against WebKit as quite a lot isn’t into [WebKitSettings](https://webkitgtk.org/reference/webkit2gtk/stable/WebKitSettings.html) and with a generic WebKit extension that should be resuseable.