mirror of
				https://github.com/ClementTsang/bottom.git
				synced 2025-10-31 03:04:01 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			56 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			56 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # CPU Widget
 | |
| 
 | |
| The CPU widget displays a visual representation of CPU usage over a time range.
 | |
| 
 | |
| <figure>
 | |
|     <img src="../../../assets/screenshots/cpu.webp" alt="A picture of an expanded CPU widget showing average CPU usage."/>
 | |
| </figure>
 | |
| 
 | |
| ## Features
 | |
| 
 | |
| The CPU widget is composed of two parts: the graph and the legend:
 | |
| 
 | |
| - The graph displays the usage data for the currently selected entry as a percentage
 | |
| - The legend displays all available entries that can be displayed on the graph along with their last recorded use percentage (except for the "All" option)
 | |
| 
 | |
| Users can scroll through the legend using either the keyboard or mouse to select which entry to display on the graph. The "All" option shows every entry
 | |
| at the same time, though this may get a bit hard to follow if you have a large number of cores/threads.
 | |
| 
 | |
| One can also adjust the displayed time range through either the keyboard or mouse, with a range of 30s to 600s.
 | |
| 
 | |
| ## Key bindings
 | |
| 
 | |
| Note that key bindings are generally case-sensitive.
 | |
| 
 | |
| ### Graph
 | |
| 
 | |
| | Binding   | Action                                  |
 | |
| | --------- | --------------------------------------- |
 | |
| | ++plus++  | Zoom in on chart (decrease time range)  |
 | |
| | ++minus++ | Zoom out on chart (increase time range) |
 | |
| | ++equal++ | Reset zoom                              |
 | |
| 
 | |
| ### Legend
 | |
| 
 | |
| | Binding            | Action                                |
 | |
| | ------------------ | ------------------------------------- |
 | |
| | ++up++ , ++k++     | Move up within a widget               |
 | |
| | ++down++ , ++j++   | Move down within a widget             |
 | |
| | ++g+g++ , ++home++ | Jump to the first entry in the legend |
 | |
| | ++G++ , ++end++    | Jump to the last entry in the legend  |
 | |
| 
 | |
| ## Mouse bindings
 | |
| 
 | |
| ### Graph
 | |
| 
 | |
| | Binding      | Action                                                         |
 | |
| | ------------ | -------------------------------------------------------------- |
 | |
| | ++"Scroll"++ | Scrolling up or down zooms in or out of the graph respectively |
 | |
| 
 | |
| ### Legend
 | |
| 
 | |
| | Binding      | Action                                            |
 | |
| | ------------ | ------------------------------------------------- |
 | |
| | ++"Scroll"++ | Scroll through options to display in the graph    |
 | |
| | ++lbutton++  | Selects a CPU thread/average to show in the graph |
 |