Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jopemachine/alfred-chromium-workflow

Chromium based browser workflow for Alfred 5
https://github.com/jopemachine/alfred-chromium-workflow

alfred alfred-workflow arc-browser awgo brave-browser chrome chrome-bookmarks chrome-canary chrome-history chrome-tabs chromium edge opera vivaldi whale whale-browser

Last synced: 2 months ago
JSON representation

Chromium based browser workflow for Alfred 5

Awesome Lists containing this project

README 

        


		Alfred-chromium-workflow


		

		

		License

		




Alfred workflow for Chromium browsers



## Why?



This workflow originated from [alfred-chrome-workflow](https://github.com/jopemachine/alfred-chrome-workflow).



The previous workflow has several [installation issues like this](https://github.com/jopemachine/alfred-chrome-workflow/issues/13#issuecomment-1103938917).



In addition to resolving installation issues, this workflow provides several following benefits over the previous one.



* Support favicon images in almost all features

* Support switching browsers, profiles with ease

* Support more Chromium based browsers

* Lightning-fast

* Provide localized subtitle



## 🌈 Features



* 📄 *Search visit histories*

* 🔖 *Search bookmark, bookmark folders*

* 📜 *Search search histories*

* 🔎 *Search download logs*

* 📒 *Search and copy your autofill data*

* 📎 *Search your opened tabs and focus, close them*



## 📌 Prerequisite



The prerequisites below are required to use that package.



* [Alfred Powerpack](https://www.alfredapp.com/powerpack/)



## 🎯 Supported Browsers



Currently supported browsers are as follows.



- [x] Chrome

- [x] Chrome Beta

- [x] Chrome Canary

- [x] Chromium

- [x] Edge

- [x] Edge Canary

- [x] Brave

- [x] Naver Whale

- [x] Epic

- [x] Vivaldi

- [x] Opera

- [x] Arc



This workflow assumes your browser is `Chrome` at default.



You can switch the browser with `ch browser`.



## 🔨 How to install



Download `alfred-chromium-workflow.alfredworkflow` on the [Release page](https://github.com/jopemachine/alfred-chromium-workflow/releases) and double click the file to add to Alfred.



* The executable is not [code-signed](https://developer.apple.com/support/code-signing/) so manual verification of the executable is required to run Alfred commands. From the Alfred Preferences' Workflows tab, right-click `alfred-chromium-workflow` in the left nav, and select "Open in Finder". Find and right-click the `alfred-chromium-workflow` executable, then click "Open" (do not simply double-click the file). You will be presented with a modal dialog that reads "macOS cannot verify the developer of “alfred-chromium-workflow”. Are you sure you want to open it?" - click Open. The warning will no longer appear during workflow usage.



* Note that if your browser is not the default browser (`Chrome`), you need to switch your browser through `ch browser` first.



* Register your customized hotkeys if you need to.



> Note : This workflow may not work on Intel Macs in versions 0.3.0 and above.



## 📗 Usage



### chb



Retrieve bookmarks.



![](./imgs/chb.png)



### chf



Retrieve bookmark folders.



![](./imgs/chf.png)



### chh



Retrieve visit histories.



Append word starting with `#` to retrieve only the logs in that domain.



Example:



`chh #github [foo bar]`



![](./imgs/chh.png)



### chd



Retrieve download histories.



![](./imgs/chd.png)



### chdc



Retrieve download histories but only show existing files.



### chs



Retrieve your search histories.



Append word starting with `#` to retrieve only the logs in that domain.



Example:



`chs #github [foo bar]`



![](./imgs/chs.png)



### cha



Retrieve autofill data.



Press enter with option key to paste the value directly.



### chid



Retrieve login data (like email).



Press enter with option key to paste the value directly.



### cho



Open new window through selected profile.



If you change your profile through `ch profile`, other commands try to work with the previously opened window.



This command would be useful in such a case.



Open new window with changed profile before the command.



### cht



Search opened tabs and focus, close them.



Tabs are sorted by their domain.



### ch browser



Switch browsers with ease.



This command also let you change the browser profile after changing the browser.



### ch profile



Switch profiles with ease.



Tip: You can check what is your Browser's profile's name in `chrome://version`.



### ch helper



Provides several useful helper features.



* Update workflow if a new version is available

* Cache favicon manually

* Open Github issues

* Open Alfred forum link

* Open READMD.md



## 🔖 Options



Configure below options through `Workflow Environment Variables`.



![](./imgs/conf.png)



### Profile



Browser's profile name.



You don't need to change this value manually.



Instead, you can change this value through `ch profile` with ease.



### CustomizedProfiles



List up your custom profile names if there are.



This could be useful when you have profiles in customized locations.



You can switch your profile through `ch profile` with `Profile {number}`, `Default` and these values.



Each profile name should be splited with comma (`,`).



### Locale



This is used to provide localized subtitles.



Refer to the following page for seeing supported locales.



https://github.com/klauspost/lctime/tree/master/internal/locales



### Browser



Browser name.



You don't need to change this value manually.



Instead, you can change this value through `ch browser` with ease.



### ResultCountLimit



Max number of items to show in Alfred.



But the maximum count limit is limited to `200` regardless of its value to prevent truncating json string.



## 🌟 Contribution



Contributions of any kind are welcome.



### Add supporting new browser



This workflow needs help to support as many browsers as possible.



To add new browser, please follow below guideline.



1. Check the browser is based on `Chromium`.

2. Add new path to `GetProfileRootPath` in `src/utils.go`.

3. Add the browser's proper Application Name to `getApplicationName` in `src/tabManager.go`. You can check this value through Applescript Editor's Dictionary.

4. Add proper `Open URL` block of `info.plist` using Alfred.

5. Add new browser's item `SelectBrowser` in `src/config.go`.

6. Add the browser name to `READMD.md`.

7. Add the browser's icon to `assets/browser-icons`.



## Related



You may also consider below workflows interesting.



- [alfred-firefox](https://github.com/deanishe/alfred-firefox/): Search and control Firefox from Alfred

- [chrome-control](https://github.com/bit2pixel/chrome-control): A JXA script and an Alfred Workflow for controlling Google Chrome



## License



MIT © [jopemachine](https://github.com/jopemachine/alfred-chromium-workflow)