autostart

README

go-autostart

A Go library to run a command after login.

Usage

package main

import (
	"log"
	"github.com/emersion/go-autostart"
)

func main() {
	app := &autostart.App{
		Name: "test",
		DisplayName: "Just a Test App",
		Exec: []string{"sh", "-c", "echo autostart >> ~/autostart.txt"},
	}

	if app.IsEnabled() {
		log.Println("App is already enabled, removing it...")

		if err := app.Disable(); err != nil {
			log.Fatal(err)
		}
	} else {
		log.Println("Enabling app...")

		if err := app.Enable(); err != nil {
			log.Fatal(err)
		}
	}

	log.Println("Done!")
}

Behavior

• On Linux and BSD, it creates a .desktop file in $XDG_CONFIG_HOME/autostart (i.e. $HOME/.config/autostart). See http://askubuntu.com/questions/48321/how-do-i-start-applications-automatically-on-login
• On macOS, it creates a launchd job. See http://blog.gordn.org/2015/03/implementing-run-on-login-for-your-node.html
• On Windows, it creates a link to the program in %USERPROFILE%\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

License

MIT

Documentation

Index

• type App
  • func (a *App) Disable() error
  • func (a *App) Enable() error
  • func (a *App) IsEnabled() bool

Types

type App

type App struct {
	// Unique identifier for the app.
	Name string
	// The command to execute, followed by its arguments.
	Exec []string
	// The app name.
	DisplayName string
	// The app icon.
	Icon string
}

An application that will be started when the user logs in.

func (*App) Disable

func (a *App) Disable() error

Disable this app on startup.

func (*App) Enable

func (a *App) Enable() error

Enable this app on startup.

func (*App) IsEnabled

func (a *App) IsEnabled() bool

Check if the app is enabled on startup.