https://github.com/supechicken/chromeos-autostart

An extension for running Linux commands at ChromeOS startup.
https://github.com/supechicken/chromeos-autostart

chromeos chromiumos crew crouton hacktoberfest tools

Last synced: 8 days ago
JSON representation

An extension for running Linux commands at ChromeOS startup.

• Host: GitHub
• URL: https://github.com/supechicken/chromeos-autostart
• Owner: supechicken
• License: gpl-3.0
• Created: 2021-02-07T13:51:20.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-08-28T10:12:57.000Z (3 months ago)
• Last Synced: 2024-08-28T11:37:46.599Z (3 months ago)
• Topics: chromeos, chromiumos, crew, crouton, hacktoberfest, tools
• Language: JavaScript
• Homepage:
• Size: 685 KB
• Stars: 44
• Watchers: 3
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

  
ChromeOS AutoStart

  
A Chrome extension for running Linux commands at ChromeOS startup, without the need of developer mode



## What can it do?

#### If you are using Crostini, you can...

- Run Linux commands in Crostini when ChromeOS boots

- Start `termina` (the underlying VM of Crostini) with custom kernel and kernel parameters

#### If you are in ChromeOS developer mode, you can...

- Run shell commands on ChromeOS boots

- Enter your crouton chroot right after logging in

## Installation

> [!IMPORTANT]

> This extension conflicts with [Secure Shell extension (development version)](https://chrome.google.com/webstore/detail/algkcnfjnajfhgimadimbjhmpaeohhln). (as this extension [used its ID](#How-does-it-works))

>

> Please remove it before installing this extension (if installed), otherwise this extension might not work as expected

- Download [the latest release of this extension (in `zip`)](https://github.com/supechicken/ChromeOS-AutoStart/releases/latest) and unzip it

- Go to `chrome://extensions` and enable Developer Mode

- Click `Load unpacked extension` and select the `ChromeOS-AutoStart-` unzipped folder

- A new window will appear and add command(s) you want to run at startup

- Optional: Click the `Test run` button to test it out after adding a command

> [!NOTE]

> Please do not delete the unzipped folder after loading the extension, otherwise the extension will get deleted after reboot

## How does it works?

There is a Chrome extension API called `chrome.terminalPrivate` which can be used to interact with the `crosh` shell, and it is only available on some extensions that are

made by Google (Secure Shell, Chromebook Recovery Utility, etc). However, we can use one of those extension's ID keys to get access to that API. (key from Secure Shell is used in this extension)

The `chrome.runtime.onStartup` listener is used to start the terminal API above automatically when ChromeOS UI starts.

## License

This project including all of its source files is released under the terms of [GNU General Public License (version 3 or later)](http://www.gnu.org/licenses/gpl.txt).