bunbun/bunbun.default.yaml

# The location which your server is listening on and binds to. You must restart
# bunbun for changes to take effect for this config option.
bind_address: "127.0.0.1:8080"

# The root location where people can access your instance of bunbun
public_address: "localhost:8080"

# A default route, if no route is was matched. If none were matched, the entire
# query is used as the query for the default route. This field is optional, but
# highly recommended for ease-of-use.
default_route: "g"

# A list containing route groups. Each route group must have a name and a
# mapping of routes, with an optional description field. Each route mapping may
# contain "{{query}}", which will be populated by the user's search query. This
# input is percent-escaped. If multiple routes are defined, then the later
# defined route is used.
#
# You may provide an (absolute, recommended) path to an executable file to out-
# source route resolution to a program. The program will receive one argument
# only, which is the entire string provided from the user after matching the
# route. It is up to the out-sourced program to parse the arguments and to
# interpret those arguments. These programs should print one line to standard
# out, which should be a fully resolved URL to lead the user to.
#
# These programs must be developed defensively, as they accept arbitrary user
# input. Improper handling of user input can easily lead to anywhere from simple
# flakey responses to remote code execution.
groups:
  -
    name: "Meta commands"
    description: "Commands for bunbun"
    routes:
      ls: &ls "/ls"
      help: *ls
      list: *ls
  -
    name: "Google"
    routes:
      g: "https://google.com/search?q={{query}}"
      yt: "https://www.youtube.com/results?search_query={{query}}"
  -
    name: "Uncategorized routes"
    description: "One-off routes with no specific grouping"
    routes:
      r: "https://reddit.com/r/{{query}}"