MozillaZine

[EXT] At Your Command

Announce and Discuss the Latest Theme and Extension Releases.
Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted May 19th, 2017, 7:53 am

Universal manager for Firefox. Manage your tabs, bookmarks, history and clipboard using powerful filtering and sorting capability. Easily select multiple items and handle them at once.

https://addons.mozilla.org/en-US/firefox/addon/at-your-command

Image
Last edited by Jan Zavřel on June 23rd, 2018, 1:38 am, edited 7 times in total.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted May 19th, 2017, 12:21 pm

BASIC TUTORIAL

1. Search modes
Currently available search modes are: Tabs (keyword t), Bookmarked Tabs (tb), Closed Tabs (tc), Bookmarks (b), History (h) and Clipboard (c).
Select search mode from Search selectbox to load all items into the grid.
Hold Shift while selecting mode to delete searchbox and just insert its keyword.
You can also press Ctrl + Alt + Up to delete searchbox and directly type keyword.
Press Enter or click Run button to run constructed query.
Tabs mode currently lists results using three columns: Name, URL, Index and Accessed.
Bookmarked Tabs mode also uses column Folder which shows all the folders respective tab is bookmarked in.
Closed Tabs mode lists results using columns: Name, URL and Closed.
Bookmarks mode lists results using columns: Name (editable), URL (editable), Folder, Index and Added.
History mode lists results using columns: Name, URL, Visits and Opened.
Clipboard mode lists results using column URL. Clipboard must contain only URLs (no mixed content) and all URLs must start with http or https.
Focus any editable column cell and press Alt + E to edit its value. Press Esc to discard changes. Press Enter to commit changes.
Focus any cell and start typing to activate find as you type feature. First cell in the same column whose value STARTS with typed characters will be immediately focused. Turn on Caps Lock before you start typing to focus first cell whose value CONTAINS typed characters.
Find as you type feature is also available when any selectbox is focused. First selectbox option whose text STARTS with typed characters will be focused.

2. Search operators
You can use column names as search operators to filter your search results.
Press Alt + Up to focus searchbox and type operator (e.g. url:).
You can abbreviate all search operators. So feel free to type u: or ur: instead of url:.
You can use multiple operators to filter your results even more. Just separate them by space.
Searchbox is case-insensitive except for folder id parameter (e.g. "test"#LaNdBdPOc8xT).
Searchbox is also space-insensitive. 1+ spaces are considered 1 space. All irrelevant spaces are ignored.
Press Tab to normalize searchbox query:
- query is validated
- all irrelevant spaces are removed
- abbreviated search operators and also operator parameters first, last, minute(s), hour(s), day(s), today, yesterday, week(s), month and quarter are completed (e.g. ad:yes is replaced by added:yesterday)
Press Ctrl + Up to remove all filters and focus searchbox.
2.1. Basic searching - by name or url
Run »t firefox« to search for tabs whose name or url contains "firefox".
Run »c firefox« to search for clipboard items whose url contains "firefox".
Run »h "at your command"« to search for history items whose name or url contains multiple-word phrase "at your command".
2.2. Searching using operators
Run »b url:firefox« to search for bookmarks whose url contains "firefox".
Run »tc name:"at your command"« to search for closed tabs whose name contains multiple-word phrase "at your command".
2.3. AND groups
Run »h (at your command)« or just »h at your command« to search for history items whose name or url contains "at" AND "your" AND "command".
Run »h name:(at your command)« to search for history items whose name contains "at" AND "your" AND "command".
2.4. OR groups
Run »b {firefox add-on "at your command"}« to search for bookmarks whose name or url contains "firefox" OR "add-on" OR multiple-word phrase "at your command".
Run »b url:{firefox add-on "at your command"}« to search for bookmarks whose url contains "firefox" OR "add-on" OR multiple-word phrase "at your command".
2.5. Starting and end anchors
Run »t ["at your command"« to search for tabs whose name or url STARTS with multiple-word phrase "at your command".
Run »tc name:" fox"]« to search for closed tabs whose name ENDS with " fox". So closed tabs whose name ends with "firefox" won’t be returned due to missing space before "fox".
Run »b folder:[test]« to search for bookmarks whose parent folder name IS "test".
2.6. Folder operator
Run »b folder:"test"#LaNdBdPOc8xT« using Folders selectbox to search for bookmarks whose parent folder id is LaNdBdPOc8xT. This is necessary if you use two or more folders of the same name.
Run »b folder:{["at your command" "test"#LaNdBdPOc8xT "Firefox"#61TNj_DI0OVW}« to search for bookmarks whose parent folder name starts with multiple-word phrase "at your command" OR whose parent folder id is LaNdBdPOc8xT OR 61TNj_DI0OVW.
Run »tb folder:"test"#LaNdBdPOc8xT« to search for tabs which are bookmarked in folder with id LaNdBdPOc8xT.
Run »tb folder:[]« to search for tabs which are NOT bookmarked in any folder.
2.7. Excluding results
Prefix word, multiple-word phrase, starting anchor, AND or OR group or search operators name, url and folder with - (hyphen) to remove items from your results.
Run »t -firefox« to search for tabs whose name or url does NOT contain "firefox".
Run »h -"at your command"« to search for history items whose name or url does NOT contain multiple-word phrase "at your command".
Run »t -["at your command"« to search for tabs whose name or url does NOT START with multiple-word phrase "at your command".
Run »tc -{at your command}« to search for closed tabs whose name or url does not contain "at" OR "your" OR "command".
Run »b -url:firefox« to search for bookmarks whose url does NOT contain "firefox".
Run »h -name:(at your command)« to search for history items whose name does NOT contain "at" AND "your" AND "command" at same time.
Run »tb -folder:test« to search for tabs which are NOT bookmarked in folders whose name contains "test".
2.8. Searching for dates
You can search for dates (added, closed and opened search operators) using:
- first/last N item(s) parameter
- N minute(s), hour(s), day(s) or week(s) parameter
- today, yesterday, week, month or quarter parameter
- single date parameter (can be prefixed by >, >=, < or <=)
- range (between) parameter
Run »b added:last10« to search for 10 last added bookmarks.
Run »t accessed:last10« to search for 10 last accessed (i.e. activated or focused) tabs.
Run »h opened:last1« to search for last opened website.
Run »tc closed:last400« to search for 400 last closed tabs.
Run »t accessed:45minutes« to search for tabs you accessed in last 45 minutes.
Run »tc closed:20minutes« to search for tabs you closed in last 20 minutes.
Run »h opened:1hour« to search for websites you opened in last 1 hour.
Run »b added:1day« to search for bookmarks you added in last 1 day.
Run »h opened:2weeks« to search for websites you opened in last 2 weeks.
Run »t accessed:today« to search for tabs you accessed today (from 0:00:00 to 23:59:59).
Run »h opened:today« to search for websites you opened today (from 0:00:00 to 23:59:59).
Run »tc closed:yesterday« to search for tabs you closed yesterday (from 0:00:00 to 23:59:59).
Run »b added:week« to search for bookmarks you added this calendar week.
Run »h opened:month« to search for websites you opened this calendar month.
Run »h opened:quarter« to search for websites you opened this calendar quarter.
Run »b added:2017-1-1« to search for bookmarks you added on January 1, 2017.
Run »h opened:>=2017-1-1« to search for websites you opened on or after January 1, 2017.
Run »h opened:>2017-1-1« to search for websites you opened after January 1, 2017.
Run »h opened:<=2017-1-1« to search for websites you opened on or before January 1, 2017.
Run »h opened:<2017-1-1« to search for websites you opened before January 1, 2017.
Run »b added:2017-1-1..2017-12-31« to search for bookmarks you added in 2017.
2.9. Searching for number values
You can search for number values (index and visits search operators) using:
- first/last N item(s) parameter
- single number value parameter (can be prefixed by >, >=, < or <=)
- range (between) parameter
Run »t index:last20« to search for last 20 tabs.
Run »h visits:first10« to search for 10 most visited websites.
Run »b folder:test index:first5« to search for first 5 bookmarks in folder whose name contains "test".
Run »t index:5« to search for tab 5.
Run »t index:>=5« to search for tabs with index 5 and higher.
Run »t index:>5« to search for tabs with index higher than 5.
Run »h visits:<=5« to search for websites you opened up to 5 times.
Run »h visits:<5« to search for websites you opened less than 5 times.
Run »b folder:test index:2..15« to search for bookmarks with index between 2 and 15 in folder whose name contains "test".
2.10. Notes
When surrounded by quotation marks, parentheses, braces and brackets have literal meaning: »b name:"(at) {your} [command]"«.
When surrounded by quotation marks, starting hyphens and/or operators have literal meaning: »b "-name:test"«.
Brackets (starting and end anchors) won’t work inside AND groups like »b url:([at your command)«. Use them like this: »b url:[at url:(your command)«.
End slashes can be omitted when using end anchors: filter url:example.com] will return both http://www.example.com and http://www.example.com/.

3. Bookmark folders
Select folder from Folders selectbox to run query »b folder:"selectedFolderName"#selectedFolderId« (i.e. to load all bookmarks from selected folder into the grid).
Hold Shift while selecting folder to delete searchbox and just insert above query.
Hold Ctrl while selecting folder to replace text selected in searchbox with folder id of selected folder. If no text is selected, folder id is inserted at current cursor position.
Shows "Other Bookmarks" and "Bookmarks Menu" content.

4. Sorting
Closed Tabs mode currently lists results sorted by column Closed in descending order.
Default sorting of other modes depends on primary operator. Primary operator is first operator in query that is not prefixed by - (hyphen).
Tabs and Bookmarked Tabs modes list results sorted by:
- column Accessed in descending order if accessed is primary operator
- column Index in ascending order otherwise
History mode lists results sorted by:
- column Visits in descending order if visits is primary operator
- column Opened in descending order otherwise
Bookmarks mode lists results sorted by:
- column Name in ascending order if there is no operator or if name or url is primary operator
- columns Folder (1) and Index (2) in ascending order if folder is primary operator
- column Added in descending order if added is primary operator
You can change default sorting by clicking a column header. The sorting order is as follows: ascending -> descending -> none.
Hold Shift while clicking columns to sort by multiple columns.
You can also focus any column cell and press Alt + A to sort results by that column in ascending order or Alt + D in descending order. Press Alt + S to reset sorting.
Sorting always takes into account accented characters.

5. Selecting items
Check checkbox or press Space to un/select item.
Hold Control and click any cell to un/select item.
Hold Shift and click any non-checkbox column cell to un/select multiple items (previous selection is not lost).
Check first item of intended selection, hold Shift and check last item to select multiple items (default behaviour). Although any previous selection is lost, you can select many thousands of items very fast this way.
Hold Shift and move up or down to un/select item.

6. Commands
Select command from Commands selectbox to run it immediately. Except for Delete command and commands which require additional parameters.
Hold Shift while selecting command to delete commandbox and just insert its keyword and parameters (if applicable).
Press Ctrl + Alt + Down (or just Ctrl + Down) to delete commandbox and type command. You can also press Alt + Down to just focus commandbox without deleting its content.
Press Enter or click Run button to run command.
Commands selectbox will always list only commands allowed in resulting search mode when you click it. Commands are not loaded when search query did not return any results.
6.1. Delete
Delete command keyword (del) is just inserted in commandbox to prevent accidental deletion of selected items. So press Enter or click Run button to confirm it.
6.2. Copy Custom
Specify keyword (cc) and single or multiple column names surrounded by percentage signs (e.g. %url%). Then type (optionally) any characters before, between or after surrounded column names. And run resulting command to replace surrounded names by respective values of selected items.
All surrounded names can be used in any order or even multiple times. You can also abbreviate them. Therefore feel free to use %u% or %ur% instead of %url%.
So if you run command »cc <a href="%url%">%name%</a>«, respective hyperlinks will be written to clipboard (if both columns are available).

7. Bookmarking/Moving items
7.1. Bookmark to Target Folder
Select folder from Bookmark selectbox to bookmark selected items to this folder.
Select folder while holding Shift to delete commandbox and just insert command keyword (bmf) and parameter (folder id of target folder).
7.2. Bookmark to New Folder
Select folder while holding Ctrl to insert command keyword (bmn) and second parameter (folder id of target folder). Then specify first parameter (name of new subfolder) and run command. Selected items will be bookmarked to newly created subfolder.
7.3. Moving items
Use commands Move to Target Folder (mf) and Move to New Folder (mn) to move existing bookmarks (in Bookmarks mode). Parameters are same as above.
7.4. Notes
You can also directly type any of above commands in commandbox: e.g. »bmn Test2 > bookmarks menu« or »mf test«.
Target folder name is case-insensitive and does not need to be surrounded by quotation marks. You need to specify full name though.

8. Queries and Commands managers
8.1. Starting manager
Press Alt + Q or click respective Save button to start Queries manager.
Press Alt + W or click respective Save button to start Commands manager.
Press Esc or run Cancel command to return to previous context. Previously selected items and settings like sorting are preserved.
8.2. Saving query or command
Run Save command from Commands selectbox to save current query (Queries manager) or command (Commands manager).
Queries manager lists saved queries using columns: Name (editable), Description (editable), Keyword (editable), Query (editable), Modified and Added.
Commands manager uses editable column Command instead of Query.
8.3. Running saved item
There are two ways to run saved query or command:
- double click query or command (you can also press Enter)
- type nothing else but its keyword in searchbox or commandbox and press Enter (or click respective Run button)
If you want to run saved command, you need to select items in previous context first.
8.4. Updating saved item
Select single saved query or command and run Save command to update it (i.e. to replace it with current query or command).
8.5. Deleting saved item(s)
Select any number of saved queries or commands and run Delete command to remove them.

9. Other notes
UI is fully responsive.
Do not use text zoom, use full zoom if needed.
Favicons are currently shown only in Tabs modes.
Hover over cell to show tooltip with whole cell text.
Press Alt + H to show help (basic info). Including keyboard shortcuts list and donation information. Donations would be much appreciated!

10. Examples of usage
Sorting Bookmark Folder
Sorting Tabs
Last edited by Jan Zavřel on June 26th, 2018, 6:46 am, edited 36 times in total.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted June 6th, 2017, 8:45 am

FEATURE REQUESTS

Skin system
Feature to copy values of all columns (done)
Last edited by Jan Zavřel on June 23rd, 2018, 1:19 am, edited 11 times in total.

yfdyh000
 
Posts: 13
Joined: April 9th, 2011, 10:11 am

Post Posted June 13th, 2017, 5:17 am

As https://addons.mozilla.org/firefox/addo ... ws/882422/, I don't see the UI style changes in version 2.1.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted June 15th, 2017, 8:44 am

I will see if support for skins can be added. Users would be able to create skins then.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted October 26th, 2017, 10:31 am

EXAMPLE OF USAGE: RESEARCH/PROJECT/TASK MANAGEMENT TOOL

Coming soon...
Last edited by Jan Zavřel on June 23rd, 2018, 1:20 am, edited 3 times in total.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted November 12th, 2017, 5:16 am

EXAMPLE OF USAGE: SORTING TABS

1. Load all tabs into the grid
2. Sort tabs (you can even use multi-column sorting)
3. Select all tabs
4. Run Move After This Tab command
Last edited by Jan Zavřel on June 23rd, 2018, 1:20 am, edited 1 time in total.

Jan Zavřel
 
Posts: 7
Joined: May 19th, 2017, 7:49 am

Post Posted November 12th, 2017, 5:40 am

EXAMPLE OF USAGE: SORTING BOOKMARK FOLDER

1. Load single bookmark folder content into the grid
2. Sort loaded bookmarks (you can even use multi-column sorting)
3. Select all bookmarks
4. Run Top Folder Positions command

Return to Extension/Theme Releases


Who is online

Users browsing this forum: No registered users and 0 guests