Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/privacyguides/privacyguides.org
Protect your data against global mass surveillance programs.
https://github.com/privacyguides/privacyguides.org
encryption markdown mkdocs mkdocs-material privacy surveillance website
Last synced: about 1 month ago
JSON representation
Protect your data against global mass surveillance programs.
- Host: GitHub
- URL: https://github.com/privacyguides/privacyguides.org
- Owner: privacyguides
- License: other
- Created: 2020-12-04T04:22:03.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T19:52:49.000Z (7 months ago)
- Last Synced: 2024-04-14T01:46:09.142Z (7 months ago)
- Topics: encryption, markdown, mkdocs, mkdocs-material, privacy, surveillance, website
- Language: Markdown
- Homepage: https://www.privacyguides.org
- Size: 72.1 MB
- Stars: 2,389
- Watchers: 40
- Forks: 188
- Open Issues: 45
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- stars - privacyguides/privacyguides.org - Protect your data against global mass surveillance programs. (Markdown)
- stars - privacyguides/privacyguides.org - Protect your data against global mass surveillance programs. (Markdown)
README
## About
**Privacy Guides** is a socially motivated website that provides information for protecting your data security and privacy. Our mission is to inform the public about the value of digital privacy, and global government initiatives which aim to monitor your online activity. We are a non-profit collective operated entirely by volunteer team members and contributors. Our website is free of advertisements and not affiliated with any of the listed providers.
The current list of team members can be found [here](https://www.privacyguides.org/en/about/#executive-committee). Additionally, [many people](#contributors) have made contributions to the project, and you can too!
*Featured on: [Tweakers](https://tweakers.net/reviews/10568/op-zoek-naar-privacyvriendelijke-tools-niek-de-wilde-van-privacy-guides.html), [The New York Times](https://nytimes.com/wirecutter/guides/online-security-social-media-privacy), [Wired](https://wired.com/story/firefox-mozilla-2022), and [Fast Company](https://www.fastcompany.com/91167564/mozilla-wants-you-to-love-firefox-again).*
## Contributing
- π¬ [Start a discussion or suggest an idea](https://discuss.privacyguides.net)
- π [Sponsor the project](https://github.com/sponsors/privacyguides)
- π΄ [Help translate the site](https://crowdin.com/project/privacyguides) [[Matrix chat](https://matrix.to/#/#pg-i18n:aragon.sh)]
- π Edit the site, everything's accessible in this repo
- Browse our [open issues](https://github.com/privacyguides/privacyguides.org/issues) to see what needs to be updated
- View the list of [approved topics waiting for a PR](https://discuss.privacyguides.net/tag/approved)
- Read some writing tips in our [style guide](https://www.privacyguides.org/en/meta/writing-style)All contributors to the site are listed [here](#contributors). If you have contributed to the website or project, please [add yourself](https://github.com/privacyguides/privacyguides.org/issues/2524) to the list or ask @jonaharagon to make the change.
## Mirrors
- **GitHub Pages:** [privacyguides.github.io/privacyguides.org](https://privacyguides.github.io/privacyguides.org/en/)
- **Netlify (AWS):** [illustrious-bavarois-56cf30.netlify.app](https://illustrious-bavarois-56cf30.netlify.app/en/)
- **BunnyCDN:** [privacyguides-org-production.b-cdn.net](https://privacyguides-org-production.b-cdn.net/en/)
- **Hetzner:** [direct.privacyguides.org](https://direct.privacyguides.org/en/) (discouraged!)### Alternative Networks
> [!NOTE]
> Most hidden service providers are not very extensively used or tested, [which is why we strongly recommend Tor](https://www.privacyguides.org/en/tor/). Using other networks could be more likely to endanger your anonymity, so make sure you know what you're doing.- **Tor/onion:** [xoe4vn5uwdztif6goazfbmogh6wh5jc4up35bqdflu6bkdc5cas5vjqd.onion](http://www.xoe4vn5uwdztif6goazfbmogh6wh5jc4up35bqdflu6bkdc5cas5vjqd.onion)
- **IPFS:** `/ipns/ipfs.privacyguides.org` (**not** anonymous)
- Please help us out by pinning a copy: [Learn more](https://github.com/privacyguides/webserver/blob/main/ipfs/README.md)
- via Cloudflare: [cloudflare-ipfs.com/ipns/ipfs.privacyguides.org](https://cloudflare-ipfs.com/ipns/ipfs.privacyguides.org/en/)
- via 4everland: [ipfs-privacyguides-org.ipns.4everland.io](https://ipfs-privacyguides-org.ipns.4everland.io/)
- via [@jonaharagon](https://github.com/jonaharagon): [ipfs.jonaharagon.net/ipns/ipfs.privacyguides.org](https://ipfs.jonaharagon.net/ipns/ipfs.privacyguides.org/en/)
- via [peer](https://docs.ipfs.tech/how-to/peering-with-content-providers/): `/dnsaddr/node-1.ipfs.jonaharagon.net/p2p/12D3KooWMwqzuApCKxYfo66zq5BrTjCoz9naJ1rrMEBCnwuGGqWB`- **I2P:** [privacyguides.i2p](http://privacyguides.i2p/?i2paddresshelper=fvbkmooriuqgssrjvbxu7nrwms5zyhf34r3uuppoakwwsm7ysv6q.b32.i2p)
- **Yggdrasil:** [http://[200:f3a6:4922:e067:770d:ac57:fcb1:8dbf]](http://[200:f3a6:4922:e067:770d:ac57:fcb1:8dbf]/en/) (**not** anonymous)
- via public peer: `tcp://5.161.245.8:45454`### Git Mirrors
[![GitHub](https://img.shields.io/static/v1?logo=github&label=&message=GitHub&color=000&style=for-the-badge)](https://github.com/privacyguides/privacyguides.org)
[![GitLab](https://img.shields.io/static/v1?logo=gitlab&label=&message=GitLab&color=000&style=for-the-badge)](https://gitlab.com/privacyguides/privacyguides.org)
[![Codeberg](https://img.shields.io/static/v1?logo=codeberg&label=&message=Codeberg&color=000&style=for-the-badge)](https://codeberg.org/privacyguides/privacyguides.org)
[![Gitea](https://img.shields.io/static/v1?logo=gitea&label=&message=Gitea&color=000&style=for-the-badge)](https://code.privacyguides.dev/privacyguides/privacyguides.org)
[![Forgejo](https://img.shields.io/static/v1?logo=forgejo&label=&message=Forgejo&color=000&style=for-the-badge)](https://git.jonaharagon.net/privacyguides/privacyguides.org)## License
Copyright Β© 2019 - 2024 [Privacy Guides contributors](#contributors).
Privacy Guides content is licensed under the [Creative Commons Attribution-ShareAlike 4.0 International Public License](/LICENSE), and the underlying source code used to format and display that content on [www.privacyguides.org](https://www.privacyguides.org) is licensed under the [MIT License](/LICENSE-CODE).
Generally speaking, **content** can be found in the [`/docs`](/docs), [`/theme/assets/img`](/theme/assets/img) and [`/includes`](/includes) folders; and **source code** and configuration files can be found in the [`/config`](/config) and [`/theme`](/theme) folders, and in the root of this repository. Any source code snippets contained within documentation files are [MIT Licensed](/LICENSE-CODE). Please contact us if you require clarification on any of these terms.
These licenses do not apply to any work where another license is otherwise noted.
**Logos** in the [`/theme/assets/img`](/theme/assets/img) folder may not be original works of Privacy Guides and therefore cannot be (re)licensed by us. We believe that these logos obtained from third-party providers are either in the public domain or **fair use**. In a nutshell, legal [fair use doctrine](https://copyright.gov/fair-use/more-info.html) allows the use of copyrighted images in order to identify the subject for purposes of public comment. However, these logos and other images may still be subject to trademark laws in one or more jurisdictions. Before using this content, please ensure that it is used to identify the entity or organization that owns the trademark and that you have the right to use it under the laws which apply in the circumstances of your intended use. *When copying content from this website, you are solely responsible for ensuring that you do not infringe someone else's trademark or copyright.*
You may comply with our license terms in any reasonable manner, but not in any way that suggests Privacy Guides endorses you or your use. You **may not** use the Privacy Guides branding in your own project without express approval from this project. Privacy Guides's brand trademarks include the "Privacy Guides" wordmark and shield logo.
When you contribute to this repository you are doing so under the above licenses, and you are granting Privacy Guides a perpetual, worldwide, non-exclusive, transferable, royalty-free, irrevocable license with the right to sublicense such rights through multiple tiers of sublicensees, to reproduce, modify, display, perform and distribute your contribution as part of our project.
## Developing
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/privacyguides/privacyguides.org?devcontainer_path=.devcontainer%2Fdevcontainer.json)
Committing to this repository requires [signing your commits](https://docs.github.com/en/authentication/managing-commit-signature-verification/signing-commits) (`git config commit.gpgsign true`) unless you are making edits via the GitHub.com text editor interface. As of August 2022 the preferred signing method is [SSH commit signatures](https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification#ssh-commit-signature-verification), but GPG signing is also acceptable. You should add your signing key to your GitHub profile.
### With `mkdocs-material`
1. Install required packages: `pip install mkdocs-material`
2. Run a local preview of the English site: `./run.sh --cmd=mkdocs`### With `mkdocs-material-insiders`
This website uses [`mkdocs-material-insiders`](https://squidfunk.github.io/mkdocs-material/insiders) which offers additional functionality over the open-source `mkdocs-material` project. For obvious reasons we cannot distribute access to the insiders repository.
**Team members** should clone the repository with `mkdocs-material-insiders` directly. This method is identical to production:
1. Clone this repository and submodules: `git clone --recurse-submodules https://github.com/privacyguides/privacyguides.org.git`
2. Enable SSH commit verification with our local [`.allowed_signers`](/.allowed_signers) file: `git config gpg.ssh.allowedSignersFile .allowed_signers`
3. Install Python **3.12**.
4. Install **pipenv**: `pip install pipenv`
5. Install dependencies: `pipenv install --dev` (install [Pillow and CairoSVG](https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/#dependencies) as well to generate social cards)
6. Serve the site locally: `./run.sh --insiders` (set `CARDS=true` to generate social cards)
- The site will be available at `http://localhost:8000`
- You can build the site locally with `./run.sh --insiders --build`
- This version of the site should be identical to the live, production versionIf you commit to `main` with commits signed with your SSH key, you should add your SSH key to [`.allowed_signers`](/.allowed_signers) in this repo.
### Local Translated Site Builds
1. Install the [Crowdin CLI Tool](https://developer.crowdin.com/cli-tool) (`brew install crowdin`)
2. Set the `CROWDIN_PERSONAL_TOKEN` environment variable to your Crowdin personal access token
3. Run `crowdin download` in the root of this repo
4. Serve the site locally: `./run.sh --insiders --lang=fr` (replacing fr with the appropriate language in [/config](/config))Translations downloaded from Crowdin are [.gitignore](/.gitignore)'d, so any local changes to the translated site cannot be committed to this repo. Actual modifications need to be made on Crowdin. As an alternative to steps 1-3, you can copy the folders from [privacyguides/i18n](https://github.com/privacyguides/i18n) to the root of this repo to obtain the translated files.
## Releasing
It is required to create a GitHub release to publish the current site to privacyguides.org. The current `main` branch can be previewed at [https://main.staging.privacyguides.dev](https://main.staging.privacyguides.dev) prior to release.
1. Create a new tag: `git tag -s YYYY.MM.DD -m 'Some message'`
- Tag numbering: `YYYY.MM.DD` - if two+ releases are published on the same day, append short commit sha to next release, e.g. `YYYY.MM.DD-6aa14e8`
- Enable GPG tag signing by default (`git config tag.gpgSign true`) to avoid missing signatures
2. Push the tag to GitHub: `git push --tags`
3. A GitHub Release will be automatically created and deployed to the live site.
- You may wish to manually check or edit the release changelog/title after it is published for accuracy.## Contributors
Privacy Guides wouldn't be possible without these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Jonah Aragon
π π π π» π π‘οΈ π π¨ π¦ π£ π¬ π¬ π§ π§βπ« οΈοΈοΈοΈβΏοΈ π€ πΉ π πΌ
Daniel Nathan Gray
π π§βπ« π π¬ π¬ π π π§ π€ π‘οΈ
Freddy
π π π π¬ π§ π π€ π¬
Niek de Wilde
π π π¬ π π π¬ π€ π π
hook9
π π¬ π π€
Aminda Suomalainen β§
π π π€ π¬ οΈοΈοΈοΈβΏοΈ π¬ π
nitrohorse
π π π€ π
Dawid Potocki
π π π€ π¨ π¬
Dale E. Wingard, Jr.
π π π€ π¬
Kewde
π π» π¬
Vince
π π» π¬
shifterovich2
π π» π¬
mfwmyfacewhen
π π€ π π¬ π¬
Tommy
π π π¬ π¬
Kai Tebay
π€ π π¬ π»
matchboxbananasynergy
π π¬ π€ π π
GitHub Actions
π
Netlify
π
Dependabot
π» π
Hetzner Cloud
π
Cloudflare
π
Open Collective
πΌ
Safing
π΅
Dan Arel
π π π¬
Techlore
π΅
elitejake
π
samsepi0l
π
rollsicecream
π π¬ π π
Henry Fisher
π
Nate Bartram
π
Sam Howell
π
asddsaz
π
Hugo Costa
π
C-O-M-P-A-R-T-M-E-N-T-A-L-I-Z-A-T-I-O-N
π
Alberto Strappazzon
π
Victorhck
π
Tai Lam
π
NinebitX
π
Alexander Antukh
π
Gusted
π
redoomed1
π π
Offpics
π
kimg45
π
djoate
π
afighttilldeath
π
Paul Verbeke
π π π π§βπ«
Mitchell Cash
π
NeverDucky
π
efb4f5ff-1298-471a-8973-3d47447115dc
π
Stephen Karl Larroque
π
0rdinant
π
Zenithium
π
Jordan Gwyn
π
Guru
π
datoshkr
π
Kcchouette
π
Jacob Neplokh
π
Leonardo Mazzon
π π π΅ π£ π¬ π
Andrew Chong
π
Wok
π
nopeitsnothing
π
Lynn Stephenson
π
Cory Solovewicz
π
noClaps
π
Brian
π
SkewedZeppelin
π π¬
Arcadius3D
π
vpnarea
π
namazso
π π¬
cYDN48
π
gjhklfdsa
π
Pavel Zolotarevskiy
π
quiddity-wp
π
Nikhil Jha
π
Subatomic Honda Civic
π
ticklemyIP
π
jermanuts
π
conorohiggins
π
TechFanTheo
π
Ryan Taylor
π
Positron832
π
JustLuckNoSkill
π
Arkadiy
π
Jack Chou
π
ave
π
Boo
π
IDKwhattoputhere
π
idkrn
π
ggg27
π
WalterKlosse
π
Tom Hacohen
π
Paul Feuvraux
π
Scott Bennett
π
Federico Ariel Castagnini
π
jslawler-gh
π
spaceoden
π
xe3
π
Andrew Morgan
π
Caleb King
π
Eduardo
π
NafeezJS
π
Sloofy
π
Sam Schlinkert
π
Gabor Luk
π
DeiAsPie
π
Davide Taviani
π
spanishharlem
π
Jacob Gonzales
π
Kaede
π
LABB
π
Raviu8
π
Peter Dave Hello
π
Rose
π
Oskar Sharipov
π
Samuel Lucas
π
NylaTheWolf
π
Matthew Davis
π
Mark Cohen
π
Mad Scientist
π
Maarten
π
William Davis
π
William Thomas Wilkins
π
wylel
π
Will Browning
π
Yi Cao
π
Yusuf Daglioglu
π
Zack
π
ZHη
π
ansuz
π
archeite
π
asdfghjz
π
ayaen
π
b-harper
π
Loic Vourch
π
crasm
π
eagerto-learn
π
egecelikci
π
elleybean
π
Evan Song
π
pynixis
π
Seirdy
π
Ryan Huang
π
Sascha P.
π
Securified
π
Sergey Musiyenko
π
Spydar007
π
Steven Bach
π
Steven Lehn
π
Steven van de Graaf
π
Sven Kortekaas
π
Tejas Gupta
π
Tebowy Seba
π
Ted Gravlin
π
TheFrenchGhosty
π
TheNoobWar
π
Thomas Rientjes
π
Tim Vergenz
π
Tom Sullivan
π
Tony Tan
π
TroubleDog54
π
User486375
π
Nicholas Christensen
π
oppressor1761
π
pbbob
π
pdjpdjpdj
π
Stella Polaris
π π¬ π£ π¬ π
regaldude
π
rusty-snake
π
sacha
π
schwukas
π
sh-dv
π
szTheory
π
Thunderbolt Digital
π
E. S. Leonesco
π
titanism
π
tomac4t
π
virustotalop
π
wintr
π
xelarate86
π
yeoneer
π
foxt
π
Freddie
π
ghbjklhv
π
Raymond Hill
π
luke crouch
π
fd1f744993de14178e6c
π
habitualname
π
hook
π
nein
π
jkhgvfgvsth
π
joaonsg
π
johnnyburnaway
π
jus9
π
kc1212
π
kryptish
π
m3t
π
macau23
π
mat1th
π
MWM
π
Michael Plews
π
moritztk
π
Aaron Horler
π
Commenter
π
CΓ©dric Laubacher
π
Daniel Peukert
π
David Breese
π
Dimitris Apostolou
π
Dyrimon
π
Ikel Atomig
π
Elias Ojala
π
Feni Brian
π
Filip Ε
π
Felix Albroscheit
π
GReagle
π
Gamma
π
GetBoz
π
GrimPixel
π
Guillem L. Jara
π
HxxxxxS
π
Himanshu Chandola
π
Issam Maghni
π
ItsDonny
π
Abdullah Atta
π
Adam Sroka
π
criadoperez
π
Alex Amiryan
π
Alex Shoup
π
Alex Thomassen
π
Amolith
π
Andrea Scarpino
π
Armando LΓΌscher
π
Ash T
π
Bernd Eichelberger
π
BionicBison05
π
Brent Gervais
π
Brian Cooper
π
Caboose700
π
Cadel Watson
π
trosel
π
Carl
π
Chad Birch
π
Chris Barry
π
JΓΊlio Ferraz
π
Jack Hill
π
Mathias Oterhals Myklebust
π
Mats Estensen
π
Matt Baer
π
Mehdi Chaouch
π
Mike Perrone
π
Mitch Wilkins
π
Mo
π
Morten Linderud
π
natzim
π
Douglas
π
Nick
π
NielDB
π
Nihal Raj
π
Noah
π
Panagiotis "Ivory" Vasilopoulos
π
Patrick R
π
Fart Attorney
π
Pilou
π
PoorPockets McNewHold
π π
PrinceKael
π
Richard
π
Jaden Site
π
Jake Zeal
π
James Kerrane
π
Sell
π
YMHuang
π
Jonathan Vansina
π
jorgeluiscarrillo
π
Julian
π
Kefaku
π
Kevin Brennan
π
Kyle Spearrin
π
Leon Allen
π
LisaWilbourn
π
Lord Shedy
π
Louis Wolfers
π
Lunush
π
MMR
π
Mads Peter Rommedahl
π
Manuel Quarneti
π
Marco Menzel
π
Mario
π
skye
π¬
r2fo
π
LamTrinh.Dev
π π π¬
frostlike
π¬
Merlin Scholz
π
jordan warne
π
DΕΎenan
π
jx tsai
π
backstab5983
π
antgig
π
Γkos NikhΓ‘zy
π
Francois Marier
π
5-tom
π
Ralphie0511
π
aleksejs1
π
Martin
π
Overwatch
π
Kieran Colfer
π
Triple T
π
IDON-TEXIST
π
Add your contributions
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of **any** kind welcome, including contributions to Privacy Guides outside of this repo, and contributions that aren't content related (like sharing ideas for Privacy Guides, promoting the project, answering questions on the forum, etc.).
CLI to generate this table:
```bash
npx --package all-contributors-cli -- npx all-contributors generate
```CLI to add a contributor:
```bash
npx --package all-contributors-cli -- npx all-contributors add
```See [this table](https://allcontributors.org/docs/en/emoji-key) for valid contribution reasons, comma-separated. Do **not** use the `content` code for contributors to the website, use `docs` instead (this way it will automatically link to their commits). Example:
```bash
npx --package all-contributors-cli -- npx all-contributors add jonaharagon docs,research,question
```