If you're a beginner you can also try bbstylemaker from the bblean menu, or launch the .exe from your bblean directory.
How To: Broams
- Broams are system commands that are available to you via the Bbkeys plugin. Bbkeys is similar to Auto Hot Key, in that you can manage certain window actions and workspaces with them. To view your bbkey.rc settings, simply navigate to Settings>Edit>bbkeys.rc. The Sourgeforge link details which commands you can use, and should be self explanatory.
99.9% of ALL Plugins will NOT FUNCTION with bbLean 64bit, and a large majority of links and documentation will not be available. Expect dead links and to be on your own.
-Using Windows Classic + 3DCC Themes for Bblean-
3DCC is a small tool which allows you complete control over your windows classic color schemes, much more so than whats available through the standard windows display preferences.
1. Put bbColor3dc.dll in your blackbox\plugins directory.
2. In your bblean menu, go to Settings>Config>Plugins and select "Add Plugin".
3. Navigate to the blackbox\plugins directory, and select "bbColor3dc.dll".
4. Load the plugin from the Settings>Config>Plugins menu.
To use 3DCC Themes with bblean, you need to make a folder in your bblean/styles directory named "3dc". After creating a theme with the program, save the file in the newly created 3dc folder. Make sure the 3dc file has the same name as your style. For example, bb_crim.3dc to work alongside bb_crim.style. You can then apply the theme by loading your style via the bblean menu. 3dc is intended for use along Windows Classic visual styles. If you get confused, a readme can be found in your bblean/plugins/bbColor3dc folder.
Have a general question about Bblean? It might be answered already, check below:
Here's an image
that will help display answers to some of the following questions!
Q: Certain task tray icons I normally see aren't appearing (battery/wifi).
A: Install bblean as a shell.
Q: How do I remove taskbar/tray/status icons?
A: The easiest way is to shift+right click the icons on your bar. Otherwise, ctrl+right click your bblean bar. Edit settings, and find this line: "bbleanbar.item: Tray". Put a "!" in front of it, so they won't load. Example
Q: How to I hide these workspace names (alpha) and the taskbar arrows?
A: Edit your bbleanbar.rc and put a "!" infront of these lines:
Q: How do I remove the side bars/slits/analog clock (etc)?
A: Unload the plugins under your configuration. The names are self explanatory.
You may also edit your plugins.rc and comment out each plugin manually with a "!"
Settings>Config>Plugins>Edit plugins.rc - Example
Q: My Volume keys on my keyboard stopped working when I installed bblean. Is there a fix?
A: Yes. Some kind anons found a fix for it that works, however it involves some scripting with Auto Hot Key. If you are unfamiliar, see the window tiling/autohotkey section.
First, download NirCMD here
. You can find links at the bottom of the page.
Extract the exes to your Windows directory (C:\Windows).
Create or add the following lines to your Auto Hot Key Script:
run nircmd.exe changesysvolume 2000
run nircmd.exe changesysvolume -2000
run nircmd.exe mutesysvolume 2
The same method with nircmd also applies to bbkeys. The code for bbkeys would look something like this:
KeyToGrab(Num9), WithModifier(Win), WithAction(ExecCommand), DoThis(C:\Blackbox\usr\bin\nircmd\nircmd.exe changesysvolume -2000)
KeyToGrab(Num0), WithModifier(Win), WithAction(ExecCommand), DoThis(C:\Blackbox\usr\bin\nircmd\nircmd.exe changesysvolume 2000)
Just edit the key you want to use for volume controls, save the .rc and restart blackbox. If you wanted to use the buttons or sliders on a media keyboard, use bbkeyhook to define them.
Run the script. You an also compile the script with Auto Hot Key, and drop it in your windows Startup folder. This will allow Windows to run it automatically on boot. Copy the compiled .exe to C:\Users\"username"\AppData\Roaming\Microsoft\Window s\Start Menu\Programs\Startup.
Q: How do I extend the width of my bbleanbar?
A: Ctrl+Right click>config>Width percent.
Alternatively, edit the bbleanbar.rc by selecting "Edit settings" and edit the bbLeanBar.widthPercent value.
Q: I want my bbleanbar to stretch across both monitors. How do I do this?
A: There are two ways to do this. The easiest (and recommended to those with equal resolution monitors) is to edit your bbleanbar.rc settings and override the max width percent by changing the value of "bbLeanBar.widthPercent" from 100 to 200. If you have uneven monitors (i.e. 1440x900 and 1366x768) you would use a value closer to 170 or so. Alternatively, you can load in a separate bbleanbar and drag it to your other monitor. You can simply clone your current settings. To do this, follow these steps:
Go to your bblean installation directory. Open the plugins folder, and find the bbLeanBar folder.
Copy + paste it in the plugins directory, and rename the folder to "bbleanbar2".
Visit Settings>Configuration>Plugins, and edit plugins.rc
Add the name of your new bar under the current bblean bar entry. It should look like this:
# - Integrated toolbar with tasks and tray
Save As plugins.rc
The bar should appear automatically, if not you should now have the option to load it within the plugins menu.
Repeat the steps provided for however many you need. Please note: ctrl+right click your current bbleanbar to drag it around if you aren't seeing the new bar load. Chances are it loaded on top of the current bar, since you cloned your settings.
Q: My Windows start button/taskbar is still appearing/glitching and getting in the way. How do I get rid of it?
A: Install BBlean as a shell. If there is still an issue, click here
Q: I've installed BBlean as a shell, how do I set my wallpaper?
A: You can do so by putting your wallpapers directory and image name in your current styles .rc settings manually, or by using bbstylemaker>other>image file name.
Alternatively, if you'd like to continue to use the same windows personalization settings for your wallpaper, you can do so by navigating to: blackbox>configuration>graphics>uncheck "enable background".
Q: Japanese characters aren't displaying. What do?
A: Under configuration, visit Misc>Use UTF-8 Encoding. Restart blackbox.
(Still not displaying? Edit your blackbox.rc in notepad++. Change the encoding to UTF-8)
Q: Firefox/my application window is weird looking/overlapping and has a flickering bar. What do?
A: This is caused by conflicts with the bbLeanSkin plugin. You can unload/disable/uncheck/toggle bbleanskin under your configuration if you choose not to use it. However there may be some ways you can get it to work through trial and error.
If you still want the skin enabled, do the following:
Put these in your Exclusions for Firefox/Nightly:
Some other exclusions were mentioned on the blackbox4windows
forums that may help pinpoint the processes causing conflicts.
For Google Chrome, put: "chrome.exe"
To turn bbleanskin off permanently, you can manually comment it out in your exclusions (blackbox>bbleanskin>edit exclusions to open the .rc). Just put a "!" in front of "plugins\bbLeanSkin\bbLeanSkin.dll". You can always uncomment it later if needed.
Some fixes that may help you get the skin to work:
For issues with explorer not being skinned properly, try disabling Aero and transparency.
Q: I can't close tabs, and Firefox is not operating properly with bblean.
A: Set Firefox to vista service pack 2 compatibility. Alternatively, downgrade firefox to before version 25. You can also just uninstall bblean as a shell.
Q: My Rainmeter skin is overlapping with my bbleanbar, what do?
A: Change the width% of your bblean bar to match your skin. If you are using bb_bar, load
the background bar on "normal", and set the bb_bar to "topmost" via your rainmeter settings.
Q: I want a 12 hour clock.
A: Change your clock format to "%I:%M"
If you want to completely remove the clock, leave the clock format window blank or put a "!" in front of "bbleanbar.item: Clock" in your bbleanbar.rc settings.
Q: Google Chrome is lagging/crashing on certain webpages ever since I started using Bblean. Whats going on?
A: This is a pretty widespread issue with Flash. I don't know why its so often reported/linked with Bblean, but the root of the problem is flash+Chrome. To fix this, navigate to:
chrome://plugins/ > click details > disable Shockwave Flash 11.5 r31
Make sure you disable the correct version.
For bug tracking and other reports on this bug, click here
You can also try navigating to: chrome://flags/ and disabling "GPU compositing on all pages" and "Threaded compositing". This has been reported as a successful fix.
-Silly + Miscellaneous-
- It just works. Has compatibility for most formats by default and is easy to customize. It's easy to achieve a simple, sleek, and minimal look. Great for beginners.
- It just works. Has compatibility for pretty much every format out of the box. Offers a few plugins and is user friendly. Easier to customize than Foobar 2000, and has a standalone skin editor. A great option for those who prefer customizing skins with Photoshop and images rather than code.
- (Probably)The most popular music player. Offers a large library of plugins, and the most diverse set of customizable skins. Panels in Foobar can also be scripted with Java. Recommended for advanced users. Looking for the Foobar 2000 Pastebin FAQ page? Click here
Alternative .fcl by Mez!!pDd+L0POgts: [link]
Since this is the most popular skin, I've gone into some detail on how to tweak it to your liking. Click here
There's always iTunes
too, if thats your thing!
***Image and Video Viewing***
Pot Player can be more CPU intensive than most video players, but performs better with larger files as a result. It can also playback music, has a built in visualizations, and native support for subtitles.
To change the ui, press "1,2,3" etc. It just works. (Video player)
A lightweight program than can batch convert, optimize, and rename images. It can even play movies and sounds.
The best option for image viewing in compressed archives (zip + rar), and ideal for Manga readers. Some skins are available on the webpage. Can default for JPG, BMP, and GIF. Note: As of the most recent updates, HoneyView no longer displays drop shadows and isn't as customizable - so be warned.
A simple image viewer made in Visual Basic. Supports .png, .jpg, and .gif. Images will scale to fit the window, but will keep their width to height ratio, so images won't look all distorted.
QuickView is a tiny picture viewer application that supports .bmp,.jpg, and .png picture format. While it can display .gif, they will not animate. It's minimal when it comes to looks, and is easy to use. Recommended as a general replacement for windows image viewer.
Thanks Yuno / !YanderexME for bringing this to my attention. The creator sadly died, and thus the domain and servers in relation to Impression Eyes with it. This download comes with a bypass for the trial version/activation servers.
Lightweight and fast image viewer that has no visible/traditional ui. Images are viewed through mouse menus and hotkeys.
Lightweight alternative image viewer for Windows. Can default for JPG, BMP, and GIF, and even PSD. Recommended more for viewing larger images like photos.
Lightest and fastest image viewer/browser inspired by vjpeg. It offers a very minimal interface, and the current executable is about 70KB uncompressed.
Note: I've attempted to split these by category, but most skins are suites that come with date/time/nowplaying. You can still edit out parts of each, and use these as a base to make your own. Keep it simple! Some of these skins may require you to extract them to your skins directory (no rmskinpackage). The default skins directory is: C:\Users\"YOURUSERNAME"\Documents\Rainmeter\Skins
No spaceship HUDs, please!
-Now Playing/Music Skins-
Read about the plugin here
- an edit that adds pixel icons, like monsterWM. This skin is made for 4 workspaces, by childbearinghips.
- Vibex's edit that adds pixel icons, like above. This skin is made for 3 workspaces.
- Makeshift taskbar shadow.
Editing Rainmeter skins is easy when you get the hang of it.
Q: I downloaded a skin for my music, but the music is not displaying. What do?
A: It's probably not set for your music player. You need to edit the skin. Manage>Edit your skin>find the line where it says "Player Name" or "player" in the code, and enter the name of your player. Valid player names: iTunes, Winamp, Foobar2000. iTunes may require an additional plugin. The use of "CAD" (for foobar) requires an additional plugin (foo_cad.dll
). Download it and place it in your components directory. You can substitute CAD for the normal player name, however you have to edit the plugin from foo_cad.dll in the skin to NowPlaying.dll.
Q: Some of these dates/times aren't set in a format I like. How can I change it?
A: Visit the Rainmeter documents on time formatting here
, and read about "Format Codes".
(Protip: These format codes also apply to the clock format in BBlean.)
Q: How do I find my "Weather Code"?
A: This depends on the skin. First, open the skin to edit it. Find the Weather measure (usually [mWeather] and see what the URL is. It would look like this -
For Yahoo: http://weather.yahooapis.com/forecastrss?p=#WeatherCode#&u=#Unit#
For Weather.com : http://xml.weather.com/weather/local/#WeatherCode#?cc=*&unit=#Unit#&dayf=6
and search by location name, not zip code.
Additional Details and further explanation available via Rainmeter documentation (here
Download includes some popular links already. Image reference for setting it up is here
Australis: A Preview of what to expect from the new Firefox 28 update
In March 2014 Mozilla plans to launch Firefox with a new UI that may limit how you can customize your browser. To read about what Australis is and how you can disable it, visit Winaeros blog:
If you are using Firefox with an alternative shell (like bblean) and getting issues (like tabs not closing) run Firefox in Windows Vista Service Pack 2 compatibility mode. Alternatively, you can downgrade Firefox to a previous verision (below verision 25). You can also just uninstall your alternative windows shell.
-ESSENTIALS FOR GETTING STARTED-
Additional Addons and Extensions:
DOM Inspector is a tool that can be used to inspect and edit the live DOM of any web document or XUL application. The DOM can be navigated using a two-paned window displaying a variety of different views on the document and all nodes within.
Change location of Status Bar Icons, Firefox Menu Button and Menu Bar and more.
Maximize your screen space by controlling the presence of Firefox window Title-bar (Caption) and borders! Hide FF's caption with 'smart' options, *optional* custom caption and resizers. - Works with ChromiFox-like themes.
Moves tabs into the titlebar in a normal (restored) window. Make sure that 'Menu Bar' is hidden and 'Tabs on Top' option is selected. You can access these options by right clicking on a toolbar in Firefox.
Theme Font & Size Changer lets you change the global font size and font family used for the user interface in Firefox. Design your browser with your favorite font. (WILL OVERWRITE YOUR CSS)
An easier way to set your "new tab" page versus dealing with about:config. Also gives you the option to "focus" on the url bar as soon as you open a new tab, so you can type and immediatley search/enter a url without clicking.
May help adjust bad font rendering.
Advanced tools for Nightly users
Forces the use of "https" secure connections whenever possible.
***FireFox (Browser) Css***
Once installed, make sure you use UI Fixer (see above additional addons) or FireFox's built in customizing menu (right click > customize on main title bar) to drag the elements you want to keep or move around. The url bar should be dragged up top to the title bar alongside the tabs with most of these styles in order to achieve the slimmest look. Drag all elements and buttons from the navigation bar before removing it. I recommend you place your addons in the addon bar if you want to access them later.
Seaweeds for FX Chrome
- Makes the tabs look chrome-ish, managable not-super-slim CSS thats more on the functional side yet still manages to be somewhat minimal. Good to use with Chrome-fx and aero themes.
More versions of Ahokas for Appows - 
Some solutions to common questions and issues with browser CSS may be reviewed at the following link. Please read the commented lines "/* */" for details about what each line does. Click Here
***4chan Userstyles + Userscripts***
What is a Userscript?
What is a Userstyle?
Userstyles allow the user to customize fonts, colors, positions of links in the margins, and many other elements of a webpage. This is done through custom Cascading Style Sheets more commonly refered too as "CSS". For more information on CSS, please see the following links:
Userscript and Userstyle
Appchan is a 2 in 1 userscript and userstyle, forked from 4chanX. It offers the most variety in options, and is easier to tweak and manage. A good start for beginners. If you have 4chan X already, disable or uninstall it. Appchan X has a custom version of 4chan X that comes with it and it will break if another 4chan X runs in parallel with it. If you have a userstyle or userscript that themes 4chan, you may want to disable it or disable Appchan X's style setting.
Continuation of the project originally started by Aeosynth almost a year ago. For a list of features and a breakdown on installation just visit the link above.
Forks of 4chanX:
Joint project of Zixaphir and Seaweed. Adds emoji by default and is good if you plan on creating your own userstyle.
Fork and continuation of Seaweeds 4chanX. If you still want to use OneeChan, this is the fork you should be using. Offers an additional feature, the ability to post images directly from a url.
An older version of 4chanX that you will need to use if you plan on using 4chanSS by Ahoka.
Adds cute bloat. Download the stable versions for the browser you prefer using.
The original css with a sidebar concept that is used alongside 4chanX. You will need to use Ahokas 4chanX fork since its not compatible with Mayhems v3. See the readme.
A clean set of styles. One offers a sidebar that functions as a thread watcher and houses custom board navigation links. Original content by Rideag and Myson. These userstyles were used alongside Seaweeds 4chanX, but you may want to try Spitties.
A set of bright and clean userstyles by HDNI. These userstyles are best used with older version of 4chanX, much like Ahokas 4chanSS. They may need some minor edits to fit your browser properly.
It's back! New mascots and new themes! Use with Seaweeds 4chanX.
Userstyle and Userscript
Super detailed animations, with posts that fade in when scrolling. Made by an anon who frequents /g/ (offlineeric)
A collection of stylesheets for several websites. If you want to learn how to write CSS for 4chan (or other webpages), this is a good project to learn from. The code is simple, and commented - so its self explanatory as long as you read the tags. There are userstyles available for not only 4chan, but Youtube, Reddit, and HackerNews as well.
***Window Managers & Other Windows Shells***
For advanced users who are confident in OS modification and ideally Linux literate.
Full Documentation is available on the webpages linked.
***Auto Hot Key Scripts***
Auto Hot Key allows you to program hotkeys, and keystrings, and commands in an easy to understand format. You can then run these scripts on windows by compiling it (creating a .exe) or running it directly through Auto Hot Key (running as .ahk). It's been most commonly used to "tile" or manage/resize windows, but has several other uses. You can remove borders and captions from windows, set up keystrings (i.e.: ty becomes "thank you" automatically), and even launch programs. It saves time, and its great for those who use long passwords or want a more efficient way to manage the way Windows functions.
The following website lists a TON of neat little applications that can do anything from tile windows to add custom toolbars in explorer and even move inactive windows. No promises they all work as intended, as its kind of outdated, however some are priceless pieces of simple code that you will use every day.
- Using IrfanView
, this script instantly saves a dated .png of your desktop once you press "print screen" to the directory of your choosing. Simply edit the directories in the script!
- Win + H to disable and Win + S to re-enable captions/titlebars on windows of your choosing.
- Removes the small icon/favicon on the top left of the program window.
When creating your own Auto Hot key scripts (like those above) these variables defined below will help you determine how windows are sized. For example:
W= Distance of the window from the left side of the screen
X= Distance of the window from the top of the screen
Y= Total width of the window
Z= Total height of the window
NumpadHome:: (defined hotkey)
WinMove,A,, 20,29,1024,512 (defined window size and position)
A list of programmable keys and their names can be found here
Alternatively, you may want to try the following:
WinSplit Revolution is a small utility which allows you to easily organize your open windows by tiling, resizing and positioning them to make the best use of your desktop real estate.
GridMove is a program that aims at making windows management easier. It helps you with this task by defining a visual grid on your desktop, to which you can easily snap windows. This program comes bundled with some predefined grid templates, that can be easily swaped, but also has ways of creating custom grids or sharing grids made by others.
***Docks and Launchers***
Launchy uses keystrokes to find and launch programs/files it indexes. The website asks for payment/donation, but it's free. Skins available on the website, and DeviantArt. Highly recommended.
One of the older and more well known docks. Probably the best alternative to Docky for Windows users. Features listed on the website.
Another older more well known name to docks. Free, but with limited functionality.
XWidget is more of a platform for customizing widgets and addons to your desktop, like clocks and weather.
XLaunchpad allows you to organize icons and shortcuts on your desktop in stacks, similar to App folders on an Android interface. XLaunchpad is probably the best option for users on a touch screen.
The closest thing to a Mac/OSX dock you can find. Full/Ultimate version requires payment, however.
Another Mac/OSX type dock. This one is free.
Flashy UI, and larger than most - but offers something different. Can be hidden with hotkeys.
Another large and intrusive dock, with a flashier UI. Can be hidden with mouse gestures.
***Chat Clients (IRC)***
-Browsing and Joining Channels-
You can contact some lurkers and frequent posters on irc.rizon.net - /list will give you a list of channels. There are some common sense channels you can join such as #4chan, #/a/, #/v/, and #/jp/; however each channel has their own sub culture and specific rules. Don't take it personally if you get kicked, banned, or muted in a channel when you're new. Some channels are also private (unlisted) or passworded. Some channels may also require you register a nickname to join. You probably shouldn't try joining a channel you are completely unfamiliar with. For more irc basics and commands, please use www.google.com. I don't mind answering stupid questions sometimes, so you can message me (xDemonessx). I'm on 24/7 and on several channels, and even though I may not always be at the computer I will respond eventually. Stay drama free, and have fun.
Steam skins are made up of .style stylesheets (similar to css) and .tga images. Editing the colors and fonts is done through the style sheets, some buttons and icons require you to edit an image in a proper format. Be aware, skins tend to break often with updates and you may need to patch it yourself.
Metro for Steam
: This steam skin allows you to customize the accent color in the form of a stand alone "settings.exe" found on the metroforsteam page.
"Hey at least its not another dark skin" comes in 21 different colors, and is consistently updated.
- Another minimal skin, uses Haxrcorp s8 as a base font.
***Vectors, Image search, and Wallpapers***
Reverse Image Search:
Super Special Thanks: pitkon, diabol, mojmir, and rtv for reviving the blackbox community and development.
Special Thanks: Ahodesuka, MayhemYDG, Zixaphir, Seaweed, and all the contributors of 4chan extensions, scripts, and styles.
Thanks: Synie!AthenaXcXo/Syn!DelRey778s, for creating the original Pastebin guide on /wg/
Original Inspirations: Anonymous, Ahoka, GET9, Lullatone, Masood, Pufin, hora hora, and Windows 7 ricers everywhere
DeviantArt Designers: neiio, kiko11, hora hora, brsev, Scope10, and more.
DeviantArt Programmers: Kishan-Bagaria, parassidhu, Mr-Ragnarok, and more.
Contributors: Anonymous ; Räv!MUNKEN0z/s ; Mono!X.FuJiWarA ; Yuuji!ZzSakai1/g ; Vibex!FL2K7hnbFY ; Mez!!pDd+L0POgts ; !YanderexME ; hal ; kori ; !RiDeag ; Scope10 ; Lullatone!ajtiI.Vexs ; and additional faggots and tripfaggots alike! Thank you, friends!