48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
# 💣Bang
|
|
|
|
*This is a fork of [unduck](https://unduck.link) by [Theo](https://github.com/t3dotgg/unduck).*
|
|
|
|
## Why fork?
|
|
|
|
This fork allows anyone to easily self host this service & add bangs for their own self-hosted websites. Bang comes pre-configured to work with
|
|
|
|
- Searxng *!s*
|
|
- Gitea *!tea*
|
|
- OpenWebUI *!ai*
|
|
- Nextcloud App Store *!cloudapp*
|
|
- Plex *!plex*
|
|
- Overseerr *!ov*
|
|
- Sonarr *!tv*
|
|
- Radarr *!mv*
|
|
- Lidarr *!mp3*
|
|
|
|
*Note: We have replaced some of the default bangs from duckduckgo with our own bangs in order to have more simple bangs for the self-hosted websites.*
|
|
|
|
You can also easily add your own bangs by adding a new entry in the bangs.ts file.
|
|
|
|
DuckDuckGo's bang redirects are too slow. Add the following URL as a custom search engine to your browser. Enables all of DuckDuckGo's bangs to work, but much faster.
|
|
|
|
```
|
|
https://bang.gbrown.org?q=%s
|
|
```
|
|
|
|
## How is it that much faster?
|
|
|
|
DuckDuckGo does their redirects server side. Their DNS is...not always great. Result is that it often takes ages.
|
|
|
|
Theo solved this by doing all of the work client side. Once you've went to https://unduck.link once, the JS is all cache'd and will never need to be downloaded again. Your device does the redirects, not me.
|
|
|
|
### How to self host
|
|
|
|
1. Clone the repo.
|
|
2. Fill out the .env.example file in the root directory & rename it to .env.
|
|
3. Run `pnpm install && pnpm build` from the root of the repo.
|
|
4. Navigate to the docker folder & fill out the .env.example file & rename it to .env.
|
|
- *Note: Our docker compose assumes you plan to select an external network.*
|
|
5. Run `sudo docker compose up -d` from within the docker directory.
|
|
|
|
### How to update the website
|
|
|
|
1. Run the bash script `update-bang` in the docker directory with the root directory of the project as the argument.
|
|
- *Note: You can also simply run it from the root or docker directory without an argument.*
|