MozillaZine

[EXT] At Your Command

Announce and Discuss the Latest Theme and Extension Releases.
Jan Zavřel
 
Posts: 9
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 22nd, 2020, 11:54 pm, edited 9 times in total.

Jan Zavřel
 
Posts: 9
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), Closed Tabs (tc), Bookmarks (b), History (h) and Clipboard (c).
You can select search mode from Search Modes drop-down list (select box). Or press either Ctrl + Alt + Up or Alt + Home to delete search box and directly type keyword. Then press Enter or click Run button.
Tabs mode currently lists results using columns: Name, URL, Index, Accessed and Folder. Column Folder shows all the folders respective page 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.
Hover over Folder column cell to show full path of bookmark.
Focus any editable column cell and press F4 or Alt + E to edit its value. Follow instructions in command box on how to commit or discard 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 focused. Turn on Caps Lock before you start typing to focus first cell whose value CONTAINS typed characters.

2. Search operators
You can use column names as search operators to filter items.
Press Alt + Up to focus search box and type operator (e.g. url:). Pressing Ctrl + Up removes all filters and focus search box.
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.
Search box is case-insensitive except for folder id parameter (e.g. "test"#LaNdBdPOc8xT).
All irrelevant spaces are ignored. 1+ spaces are considered 1 space.
Press Tab to normalize query:
- query is validated
- all irrelevant spaces are removed
- abbreviated search operators and 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)
2.1. Basic searching - by name or url
»t firefox« shows tabs whose name or url contains "firefox".
»c firefox« shows clipboard items whose url contains "firefox".
»h "at your command"« shows history items whose name or url contains multiple-word phrase "at your command".
2.2. Searching using operators
»b url:firefox« shows bookmarks whose url contains "firefox".
»tc name:"at your command"« shows closed tabs whose name contains multiple-word phrase "at your command".
2.3. AND groups
»h (at your command)« or just »h at your command« shows history items whose name or url contains "at" AND "your" AND "command".
»h name:(at your command)« shows history items whose name contains "at" AND "your" AND "command".
2.4. OR groups
»b {firefox add-on "at your command"}« shows bookmarks whose name or url contains "firefox" OR "add-on" OR multiple-word phrase "at your command".
»b url:{firefox add-on "at your command"}« shows bookmarks whose url contains "firefox" OR "add-on" OR multiple-word phrase "at your command".
2.5. Starting and end anchors
»t ["at your command"« shows tabs whose name or url STARTS with multiple-word phrase "at your command".
»tc name:" fox"]« shows closed tabs whose name ENDS with " fox". So closed tabs whose name ends with "firefox" won’t be showed due to missing space before "fox".
»b folder:[test]« shows bookmarks whose parent folder name IS "test".
2.6. Folder operator
»b folder:firefox« shows bookmarks whose parent folder name contains firefox.
»b folder:"test"#LaNdBdPOc8xT« shows bookmarks whose parent folder id is LaNdBdPOc8xT. Using folder id is necessary if you created two or more folders of the same name. You may want to select folder from Bookmark Folders drop-down list in this case.
»b folder:{["at your command" "test"#LaNdBdPOc8xT "Firefox"#61TNj_DI0OVW}« shows bookmarks whose parent folder name starts with multiple-word phrase "at your command" OR whose parent folder id is LaNdBdPOc8xT OR 61TNj_DI0OVW.
»t folder:"test"#LaNdBdPOc8xT« shows tabs which are bookmarked in folder with id LaNdBdPOc8xT.
»t folder:[]« shows 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.
»t -firefox« shows tabs whose name or url does NOT contain "firefox".
»h -"at your command"« shows history items whose name or url does NOT contain multiple-word phrase "at your command".
»t -["at your command"« shows tabs whose name or url does NOT START with multiple-word phrase "at your command".
»tc -{at your command}« shows closed tabs whose name or url does NOT contain "at" OR "your" OR "command".
»b -url:firefox« shows bookmarks whose url does NOT contain "firefox".
»h -name:(at your command)« shows history items whose name does NOT contain "at" AND "your" AND "command" at same time.
t -folder:test« shows tabs which are NOT bookmarked in folders whose name contains "test".
2.8. Searching for dates
You can filter 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
»b added:last10« shows 10 last added bookmarks.
»t accessed:last10« shows 10 last accessed (i.e. activated or focused) tabs.
»h opened:last1« shows last opened website.
»tc closed:last400« shows 400 last closed tabs.
»t accessed:45minutes« shows tabs accessed in last 45 minutes.
»tc closed:20minutes« shows tabs closed in last 20 minutes.
»h opened:1hour« shows websites opened in last 1 hour.
»b added:1day« shows bookmarks added in last 1 day.
»h opened:2weeks« shows websites opened in last 2 weeks.
»t accessed:today« shows tabs accessed today (from 0:00:00 to 23:59:59).
»h opened:today« shows websites opened today (from 0:00:00 to 23:59:59).
»tc closed:yesterday« shows tabs closed yesterday (from 0:00:00 to 23:59:59).
»b added:week« shows bookmarks added this calendar week.
»h opened:month« shows websites opened this calendar month.
»h opened:quarter« shows websites opened this calendar quarter.
»b added:2017-1-1« shows bookmarks added on January 1, 2017.
»h opened:>=2017-1-1« shows websites opened on or after January 1, 2017.
»h opened:>2017-1-1« shows websites opened after January 1, 2017.
»h opened:<=2017-1-1« shows websites opened on or before January 1, 2017.
»h opened:<2017-1-1« shows websites opened before January 1, 2017.
»b added:2017-1-1..2017-12-31« shows bookmarks added in 2017.
2.9. Searching for number values
You can filter 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
»t index:last20« shows last 20 tabs in tabstrip.
»h visits:first10« shows 10 most visited websites.
»b folder:test index:first5« shows first 5 bookmarks in folder whose name contains "test".
»t index:5« shows fifth tab in tabstrip.
»t index:>=5« shows all tabs in tabstrip except for first 4.
»t index:>5« shows all tabs in tabstrip except for first 5.
»h visits:<=5« shows websites opened up to 5 times.
»h visits:<5« shows websites opened up to 4 times.
»b folder:test index:2..15« shows 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 show both http://www.example.com and http://www.example.com/.

3. Bookmark folders
Select folder from Bookmark Folders drop-down list to load all containing bookmarks into the grid (query »b folder:"selectedFolderName"#selectedFolderId« is executed).
Drop-down list shows Bookmarks Menu, Bookmarks Toolbar, Other Bookmarks and Mobile Bookmarks content.
And is updated automatically as folders are renamed, moved, deleted or created (even outside of At Your Command add-on).

4. Sorting
Default sorting depends on primary operator. Primary operator is first operator in query that is not prefixed by - (hyphen).
Tabs mode sorts results by:
- column Accessed in descending order if accessed is primary operator
- column Index in ascending order otherwise
Closed Tabs mode sorts results by:
- column Closed in descending order no matter the operator
Bookmarks mode sorts results by:
- columns Folder (1) and Index (2) in ascending order if folder is primary operator
- column Name in ascending order if name or url is primary operator
- column Added in descending order if added is primary operator or if there is no filter at all
History mode sorts results by:
- column Visits in descending order if visits is primary operator
- column Opened in descending order otherwise
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
5.1. Selecting Single Item
Click favicon on the left of each row to un/select row (item).
Hold Control and click any row to un/select item.
Hold Shift and move up or down to un/select item.
Press Space to un/select item.
Unselection occurs if current item is selected. And vice versa.
Previous selection (elsewhere in grid) is not lost.
5.2. Selecting Multiple Items
Click the first row, hold Shift and click any other row to un/select items in range.
Press Shift + Home to un/select all items from current row to top.
Press Shift + End to un/select all items from current row to bottom.
Unselection occurs if first (original) item is selected. And vice versa.
Previous selection (elsewhere in grid) is not lost.
5.3. Selecting All Items
Click checkbox on the left of header row to un/select all items.
Press Ctrl + A to un/select all items.
Unselection occurs if all items are selected.
5.4. Inverting selection
Press Ctrl + I to invert selection.

6. Commands
Click any command bar button to run respective command. You can also press Ctrl + Alt + Down, Ctrl + Down or Alt + End to delete command box and type command. Then press Enter or click Run button.
Press Alt + Down to just focus command box without deleting its content.
Commands which require additional parameters or explanation:
6.1. 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 command to replace surrounded names by respective values of selected items and copy result to clipboard.
Specify %path% in bookmarks mode to export full path of bookmark.
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 copied to clipboard (if both columns are available).

7. Bookmarking/Moving items
7.1. Bookmark to Target Folder
Select folder from Bookmark drop-down list to bookmark selected items to it.
7.2. Bookmark to New Folder
Select Create New Folder (last item in the same drop-down list) and follow instructions in command box.
7.3. Move to Target Folder
Select folder from Move drop-down list to move selected bookmarks to it (Bookmarks search mode only).
7.4. Move to New Folder
Select Create New Folder (last item in the same drop-down list) and follow instructions in command box.
7.5. Notes
You can also directly type commands in command box:
»bmf test« bookmarks selected items to folder Test.
»bmn Test2 > test« or »bmn Test2« and selecting folder Test from drop-down list bookmarks selected items to new folder Test2.
»mf test« moves selected bookmarks to folder Test.
»mn Test2 > test« or »mn Test2« and selecting folder Test from drop-down list moves selected bookmarks to new folder Test2.
Folder name (except new folder) is case-insensitive and does not need to be surrounded by quotation marks. You need to specify full name though.

8. Query and Command Managers
8.1. Starting manager
Press Alt + Q or click respective Save button to start Query Manager.
Press Alt + W or click respective Save button to start Command Manager.
Press Esc or click Cancel button to return to previous context. Previously selected items and settings like sorting are preserved.
8.2. Saving query or command
Click Save As New button to save current query (Query Manager) or command (Command Manager).
Query manager lists saved queries using columns: Name (editable), Description (editable), Keyword (editable), Query (editable), Modified and Added.
Command manager lists saved commands using columns: Name (editable), Description (editable), Keyword (editable), Command (editable), Modified and Added.
8.3. Running saved item
There are two ways to run saved query or command:
- double click query or command (you can also focus item and press Enter)
- type nothing else but its keyword in search or command box and press Enter or click respective Run button
If you want to run saved command in manager, you need to select items in previous context first.
You can type (and run) keyword anywhere. You do not need to start respective manager first.
8.4. Updating saved item
Select single saved query or command and click Save button to replace it with current query or command. All other information is preserved (keyword etc.).
8.5. Deleting saved item(s)
Select any number of saved queries or commands and click Delete button to remove them.

9. Other notes
UI is fully responsive.
Do not use text zoom, use full zoom if needed.
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
See http://forums.mozillazine.org/viewtopic.php?p=14863172#p14863172
Last edited by Jan Zavřel on June 23rd, 2020, 12:54 am, edited 56 times in total.

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

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

FEATURE REQUESTS

Load tabs from all windows
Duplicate finder

DONE
Hovering over folder cell in bookmarks mode shows full path
Better looks of user interface
Feature to copy values of all columns
Last edited by Jan Zavřel on May 25th, 2020, 3:12 am, edited 24 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: 9
Joined: May 19th, 2017, 7:49 am

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

Made some style changes in versions 7, 7.7 and 7.8. Will focus on this more from now on...
Last edited by Jan Zavřel on May 25th, 2020, 5:05 am, edited 4 times in total.

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

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

CHANGELOG

See https://addons.mozilla.org/en-US/firefox/addon/at-your-command/versions for changelog. Legend:
[+] - added
[-] - removed
[x] - changed
[*] - fixed, updated
Last edited by Jan Zavřel on May 25th, 2020, 3:16 am, edited 20 times in total.

Jan Zavřel
 
Posts: 9
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: 9
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


ychaouche
 
Posts: 8
Joined: April 5th, 2015, 6:47 am

Post Posted July 16th, 2020, 3:25 am

Dear Jan,

Please see following video of malfunctionning addon : https://vimeo.com/438855587

in my case it always says no bookmark selected when I try to do an action, when I already have selected the desired bookmark !

Waiting to hear from you soon,
Yassine.

Return to Extension/Theme Releases


Who is online

Users browsing this forum: Google [Bot] and 1 guest