homepage

Documentation

Index

• Variables
• func InitOverridesConfig()
• type Category
• type Homepage
  • func (c Homepage) Add(item *Item)
• type IconExtra
• type IconSource
• type IconURL
  • func NewSelfhStIconURL(reference, format string) *IconURL
  • func NewWalkXCodeIconURL(name, format string) *IconURL
  • func (u *IconURL) HasIcon() bool
  • func (u *IconURL) MarshalText() ([]byte, error)
  • func (u *IconURL) Parse(v string) error
  • func (u *IconURL) String() string
  • func (u *IconURL) URL() string
  • func (u *IconURL) UnmarshalText(data []byte) error
• type Item
  • func (item *Item) MarshalJSON() ([]byte, error)
• type ItemConfig
  • func (cfg *ItemConfig) GetOverride(alias string) *ItemConfig
• type OverrideConfig
  • func GetOverrideConfig() *OverrideConfig
  • func (c *OverrideConfig) GetOverride(alias string, item *ItemConfig) *ItemConfig
  • func (c *OverrideConfig) HideItems(keys []string)
  • func (c *OverrideConfig) OverrideItem(alias string, override *ItemConfig)
  • func (c *OverrideConfig) OverrideItems(items map[string]*ItemConfig)
  • func (c *OverrideConfig) SetCategoryOrder(key string, value int)
  • func (c *OverrideConfig) UnhideItems(keys []string)

Variables

var ErrInvalidIconURL = gperr.New("invalid icon url")

var PredefinedCategories = map[string]string{
	"sonarr":       "Torrenting",
	"radarr":       "Torrenting",
	"bazarr":       "Torrenting",
	"lidarr":       "Torrenting",
	"readarr":      "Torrenting",
	"prowlarr":     "Torrenting",
	"watcharr":     "Torrenting",
	"qbittorrent":  "Torrenting",
	"qbit":         "Torrenting",
	"qbt":          "Torrenting",
	"transmission": "Torrenting",

	"jellyfin":   "Media",
	"jellyseerr": "Media",
	"emby":       "Media",
	"plex":       "Media",
	"navidrome":  "Media",
	"immich":     "Media",
	"tautulli":   "Media",
	"nextcloud":  "Media",
	"invidious":  "Media",

	"uptime":             "Monitoring",
	"uptime-kuma":        "Monitoring",
	"prometheus":         "Monitoring",
	"grafana":            "Monitoring",
	"netdata":            "Monitoring",
	"changedetection.io": "Monitoring",
	"changedetection":    "Monitoring",
	"influxdb":           "Monitoring",
	"influx":             "Monitoring",

	"adguardhome":  "Networking",
	"adgh":         "Networking",
	"adg":          "Networking",
	"pihole":       "Networking",
	"flaresolverr": "Networking",

	"homebridge":     "Home Automation",
	"home-assistant": "Home Automation",

	"dockge":       "Container Management",
	"portainer-ce": "Container Management",
	"portainer-be": "Container Management",
	"logs":         "Container Management",
	"dozzle":       "Container Management",

	"rss":        "RSS",
	"rsshub":     "RSS",
	"rss-bridge": "RSS",
	"miniflux":   "RSS",
	"freshrss":   "RSS",

	"paperless":     "Documents",
	"paperless-ngx": "Documents",
	"s-pdf":         "Documents",
	"stirling-pdf":  "Documents",

	"minio":       "Storage",
	"filebrowser": "Storage",
	"rclone":      "Storage",
}

PredefinedCategories by alias or docker image name.

Functions

func InitOverridesConfig

func InitOverridesConfig()

Types

type Category

type Category []*Item

type Homepage

type Homepage map[string]Category

func (Homepage) Add

func (c Homepage) Add(item *Item)

type IconExtra

type IconExtra struct {
	FileType string `json:"file_type"`
	Name     string `json:"name"`
}

type IconSource

type IconSource int

const (
	IconSourceAbsolute IconSource = iota
	IconSourceRelative
	IconSourceWalkXCode
	IconSourceSelfhSt
)

type IconURL

type IconURL struct {
	Value      string `json:"value"`
	FullValue  string `json:"full_value"`
	IconSource `json:"source"`
	Extra      *IconExtra `json:"extra"`
}

func NewSelfhStIconURL

func NewSelfhStIconURL(reference, format string) *IconURL

func NewWalkXCodeIconURL

func NewWalkXCodeIconURL(name, format string) *IconURL

func (*IconURL) HasIcon

func (u *IconURL) HasIcon() bool

HasIcon checks if the icon referenced by the IconURL exists in the cache based on its source. Returns false if the icon does not exist for IconSourceSelfhSt or IconSourceWalkXCode, otherwise returns true.

func (*IconURL) MarshalText

func (u *IconURL) MarshalText() ([]byte, error)

func (*IconURL) Parse

func (u *IconURL) Parse(v string) error

Parse implements strutils.Parser.

func (*IconURL) String

func (u *IconURL) String() string

func (*IconURL) URL

func (u *IconURL) URL() string

func (*IconURL) UnmarshalText

func (u *IconURL) UnmarshalText(data []byte) error

UnmarshalText implements encoding.TextUnmarshaler.

type Item

type Item struct {
	*ItemConfig

	Alias    string
	Provider string
}

func (*Item) MarshalJSON

func (item *Item) MarshalJSON() ([]byte, error)

type ItemConfig

type ItemConfig struct {
	Show         bool           `json:"show"`
	Name         string         `json:"name"` // display name
	Icon         *IconURL       `json:"icon"`
	Category     string         `json:"category"`
	Description  string         `json:"description" aliases:"desc"`
	SortOrder    int            `json:"sort_order"`
	WidgetConfig map[string]any `json:"widget_config" aliases:"widget"`
}

func (*ItemConfig) GetOverride

func (cfg *ItemConfig) GetOverride(alias string) *ItemConfig

type OverrideConfig

type OverrideConfig struct {
	ItemOverrides  map[string]*ItemConfig `json:"item_overrides"`
	DisplayOrder   map[string]int         `json:"display_order"`  // TODO: implement this
	CategoryOrder  map[string]int         `json:"category_order"` // TODO: implement this
	ItemVisibility map[string]bool        `json:"item_visibility"`
	// contains filtered or unexported fields
}

func GetOverrideConfig

func GetOverrideConfig() *OverrideConfig

func (*OverrideConfig) GetOverride

func (c *OverrideConfig) GetOverride(alias string, item *ItemConfig) *ItemConfig

func (*OverrideConfig) HideItems

func (c *OverrideConfig) HideItems(keys []string)

func (*OverrideConfig) OverrideItem

func (c *OverrideConfig) OverrideItem(alias string, override *ItemConfig)

func (*OverrideConfig) OverrideItems

func (c *OverrideConfig) OverrideItems(items map[string]*ItemConfig)

func (*OverrideConfig) SetCategoryOrder

func (c *OverrideConfig) SetCategoryOrder(key string, value int)

func (*OverrideConfig) UnhideItems

func (c *OverrideConfig) UnhideItems(keys []string)