Nitab di Nima Askarian

Nitab is an open source, fully customizable and advanced start page and new tab page for your browser. You can add commands (aliases), add a taskbar of links, or have multiple themes and backgrounds.
Checkout Nitab on Github if you have any issues, questions, or you just wanna hangout!
Attention: You'll need to allow for pop-ups for this extension to work.

Basics

• The Terminal
  If you type anything on Nitab, It'll open a window with a text input on it. Thats what we call Terminal. You can type and press "Enter key" to search google with anything that you typed.
  You can hold while pressing "Enter key" to open the result in a new tab.
  You can reverse this functionality by pressing "Ctrl + B" or "Alt + B".
  You can also type commands. Nitab will suggest default and your own commands to you based on what you typed.
  You can navigate between suggestions using "Arrow keys" or "Mouse" and you can apply its content to your Terminal using "Tab key" or "Mouse Left Click".
  Nitab can also suggest based on your Bookmarks, Tabs and History. You can circle between them or turn it off using "Ctrl + Q" or "Alt + Q".
  These suggestions can be accessed using "Mouse Left Click" or "Ctrl or Alt + <key of index of item>". For example, If you want to open second item, You can use both "Alt + 2" and "Ctrl + 2". You can use both numpad and num-row keys.
  Attention: If I ever mentioned Terminal in the following text, I'm referring to this Terminal. You don't need any external application in order to customize Nitab
  


• The Main
  First page you see when you open Nitab. It contains your To-dos, taskbar and clock.
  
  
  • To-dos
    You can temporarily close them using X button, delete them using Trash can button, Or mark it as "finished" using Circle button.
    If its finished, You can un-finish it using Circle Check button.
    Attention You can't add todos using GUI at the time. It will be an update for this very soon. You can add them using Terminal
    
  
  
  • Clock
    You can switch between 24h and 12h format by clicking on clock itself.
    You can switch to Persian date by clicking on date.
    
  
  
  • Weather
    You can see detailed weather by clicking on weather icon or the temperature. You also can change weather settings in Side menu by clicking on weather's city name.
    You can turn on or off automatic weather using its checkbox in weather settings.
    You can search and add cities that are your favorite and then select the city you want.
    You also can delete cities that you've added.
    Weather data will refresh every 30 minutes.
    
  
  
  • Taskbar
    You can use taskbar by clicking on each icon, or use "Alt + <taskbar item index>". For example, You want to open second taskbar item using your keyboard. You'll have to press "Alt + 2". both numpad and num-row keys can be used.
    

Features

• Adding Commands
  You can add commands using your Nitab's terminal and the syntax below:
  
  
  • Simple Commands
    /command cmdName cmdUrl
    ex: /command ig instagram.com
    then if you run: /ig it'll open: instagram.com
    
  
  
  • Multiple-url commands
    /command cmdName url1 url2 url3 url4 ...
    ex: /command ent youtube.com netflix.com store.steampowered.com
    then if you run: /ent it'll open: each of those three sites in a new tab
    
  
  
  • Commands with inputs
    /command cmdName %input%
    ex: /command ig instagram.com/%input%
    then if you run: /ig slipknot it'll open: instagram.com/slipknot
    
  
  
  • Conditional commands
    /command cmdName doesntHaveInput%?%hasInput
    ex: /command igOrYt instagram.com%?%youtube.com
    then if you run: /igOrYt it'll open: instagram.com
    and if you run: /igOrYt anything it'll open: youtube.com
    
  
  
  • Commands customization
    
    • Icon:
      /command cmdName icon:"font awesome class name"
      ex: /command ig icon:"fab fa-instagram"
      
    • Color:
      /command cmdName color:"css color value"
      ex: /command ig color:"pink"
      ex: /command ig color:"#dd2a7b"
      ex: /command ig color:"rgba(221,42,123,0.5)"
      
  
  You may combine any of patterns above into one command. You can also customize all system default commands with your icon and color of choice.
  


• Visual Customizations
  You can somewhat fully customize your Nitab! you can change almost everything so it fits your taste!
  
  
  • Clock Configuration
    You can set Nitab's clock align and position using /clock position align
    "position" Can be any of these values: center, right, left
    "align" Can be any of these values: center, end, start
    ex: /clock center end
    ex: /clock right start
    
  
  
  • Foreground Color
    Color of clock, terminal, autocomplete, and other GUI elements except for taskbar.
    You can either use /fg color or /fg ovr color
    The "ovr" will override your commands color and set your Terminal to a constant color.
    "color" is as css's color property. You can put color names, rgb, hex, rgba, hsl, hsla and etc.
    ex:
    
    • /fg ovr black
    • /fg rgba(130,20,80)
    • /fg ovr #cdfa5b
  
  
  • Backgrounds
    You can add multiple backgrounds to your Nitab.
    Nitab's background can be set to a gradient, a solid color or an image or an images url.
    If you want to go with image, You can either drag and drop the images from your local system to nitab or you can set a random image from your Unsplash collections using /bg un
    If you want to go with anything other than image, you should use a css value. it can be a gradient, a solid color or url.
    heres how its done:
    • /bg black
    • /bg linear-gradient(45deg, rgba(81,96,117,1) 0%, rgba(159,184,232,1) 100%)
    • /bg url("https://urlYouWant/path/to/wallpaper.jpg")
    When you set a new background, Nitab will automatically set your background to the new background. However, You can always choose your current background manually using the syntax below:
    /bg index
    
    • ex: if you run /bg 0 it'll set your background to your first background
      
    • ex: if you run /bg 1 it'll set your background to your second background
      
    • ex: if you run /bg 5 it'll set your background to your 6th background
      
    And so on.
    
    You can customize each background with its own brightness, blur and parallax.
    
    • Brightness
      You can set your current background brightness using syntax below:
      /br main terminal editingTaskbar
      These values can be a number. You probably want to go with something between 0 and 1. 0 means complete darkness, and 1 means normal. Anything above 1 is considered brighter than normal and may reduce picture quality if set to higher number.
      ex: If you run /br 1 0.8 0.6 it will set your brightness to normal when you are in main. 0.8 (20% darker) when you are in Terminal, and 0.6 (40% darker) when you are editing your taskbar.
      
    Blur
    You can set your current background blur using syntax below:
    /bl main terminal editingTaskbar
    These values are pixels. Basically 100 considered very very blurry, And you probably won't notice 1 pixel of blur.
    You don't need to type "px" of "pixel" in front of these values. You only gonna need to type the value in number.
    ex: /bl 5 10 20
    These three values are exactly like brightness values and will be set to main, terminal and when you are editing your taskbar.
    
    • Parallax
      Parallax effect will make your wallpaper move if you move your mouse cursor. Cool huh?
      You can toggle it using the command below:
      /par
      You can set its zoom factor (percentage) using the syntax below:
      /par percentage
      ex: /par 10
      Default value for percentage is 5. You can set it to lower or higher value. Even to a negative value! You can try different values out and find what suits you the best.
      
  
  
  • Unsplash Collections
    You can set your desired Unsplash collections for nitab using:
    /un collectionId
    collectionId can is ID of the Unsplash collection of your choice.
    ex: You liked a unsplash collection and its url is something like url shown below:
    https://unsplash.com/collections/932210/snow
    The set of characters that are after the "collections/". so the collection id is "932210". Now you can use: /un 932210 to set your Unsplash collection.
    If you got multiple collection IDs like above, You can add them using following syntax:
    /un collectionId,anotherCollectionId,yetAnotherId
    And so on.
    
  
  
  • Themes
    You can add multiple themes in Nitab. each theme has its own clock configuration, foreground color, current background, font and whether your background is random or not.
    You can view, add, delete or switch between themes in side menu. just run: /themes
    It'll open a menu in your side menu called themes. You can add a blank theme so you customize it using your Terminal later, Or you can switch between your themes, Or delete each of them using Trash button.
    You can do all things above using Terminal.
    You can add a new blank theme using: /themes add
    If you want to set you current theme, you should use following syntax:
    /themes index
    Theme's index is just like background index, Heres some examples again:
    
    • ex: if you run /themes 0 it'll set your current theme to your first theme
      
    • ex: if you run /themes 1 it'll set your current theme to your second theme
      
    • ex: if you run /themes 5 it'll set your current theme to your 6th theme
      
    And so on.
    You can delete themes using syntax above and adding "delete" keyword to the end of it:
    /themes index delete
    ex: if you run /themes 0 delete it'll delete your current theme.
    And the rest is just like setting your theme.
    If you constantly change your Operating System's theme, Then you'll need your browser to follow it too! You can set "dark" and "light" themes in Nitab, so it'll change based on your system's preferred theme! You can do such using syntax below:
    
    • Will set your theme of choice for when your system theme is set to dark:
      /themes index dark
      
    • Will set your theme of choice for when your system theme is set to light:
      /themes index light
      
    The index is calculated just like prior syntaxes about themes!
    You can delete your dark or light theme and change your current theme manually using following syntax:
    
    • /theme delete dark
/theme delete light
      
    Attention: When you are setting the following customizations, It will be applied to your currently selected theme. Anything other than these, Is global between themes and they share the same settings:
    
    • Clock Configuration
      
    • Current Background Index
      
    • Foreground
      
    • Font
      
    • Unsplash Collections
      
    • Whether is Background random or not
      


• Customizing your Taskbar
  You can add icons to your taskbar. Its like a quick access bar but its highly customizable.
  You can open taskbar menu using following command: /taskbar
  You can add icons by drag and dropping or by clicking "Add" button.
  You can click on icons to customize them, Or double click to delete them. While you editing, You can switch to "Add" menu by pressing Plus button.
  Other options are pretty self-explanatory.
  


• Adding To-dos
  You can add to-dos using following syntax: /todo message
  The message can be whatever you want Nitab to remind you of.
  ex: /todo checkout chapeltown rag on youtube
  ex: /todo don't forget to buy milk
  You can view, add, delete, or mark your to-dos as finished in side menu. You can open to-dos in side menu using following command: /todo
  Or by clicking on to-do reminder, in the Main, below the clock.