Allows you to space icons on your iOS homescreen without a jailbreak.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
readme_images
README.md
springboard_spacer.sh

README.md

iOS-Springboard-Spacer

What Is It?

iOS Springboard Spacer is a shell script which helps you gain more control over icon placement and achieve custom layouts. It does not require a jailbreak.

Which Devices Does It Support?

The script is generic enough to support several screen sizes, but currently only supports the iPhone 5, 5S, 6 and the iPod Touch 5G (iOS 7 and later) and the iPhone 4, 4S and the iPod Touch 4G (iOS 6 and earlier). I would be happy to add support for other screen sizes if the demand is there, just drop me a message here on GitHub.

How Does It Work?

The script produces "fake" home screen icons which exactly match your background. When placed correctly, these give the appearance of empty space on your homescreen.

How do I use It?

You'll need a bit of terminal knowhow to get this to work. These instructions are aimed at Mac and Linux users. Windows users should be able to achieve the same effect by use of Cygwin.

Step 1: Install ImageMagick

If you're a Mac user, you can install it with homebrew. Linux and Windows users can either use their package manager of choice, or download it from the website

Mac users can use homebrew as follows:

brew install imagemagick

Step 2: Take an Screenshot of an Empty Homescreen

To do this, hold your finger down on any app icon until the app icons begin to wiggle. Now, swipe to the rightmost screen which should be devoid of icons:

Take a screenshot by pressing the home and power buttons simultaneously.

Step 3: Copy the Image to Your Computer

Using your image transfer app of choice, copy the screenshot from your iOS device to your computer.

Step 4: Run the Script

Create an empty directory for output, and then run the script providing the screenshot image you took in Step 3 and the empty directory you created as arguments:

./springboard_spacer.sh --file_name /path/to/screenshot.png --output_dir /path/to/output/directory

Step 5: Share the Output via Apache

Using Apache, share the files in the created directory on your local network at a location that can be reached with Safari on your iOS device.

Step 6: Install and Place the Icons

Launch Safari on your iOS device and visit the index.html file created by the script. You will be presented with a screen like so:

The arrangement of the grid will vary depending on the dimensions of the screenshot provided to the script. Click a location which corresponds to the location on your homescreen where you want to insert the space. You will be presented with the following page:

Click the share icon and choose "Add to Home Screen" from the options:

Add the icon to your homescreen, being sure to leave the page title blank:

You will find the icon appears on your homescreen, and you should now place it in the correct position in the same way you would place any other app icon.

You can then return to Safari and go back to the previous page to add more icons.

FAQ

What are the limitations?

Many ;) This is more of a curiosity than an actual workaround for icon placement. Some limitations include:

  • Buffer icons are visible when swiping between home screens. As a partial workaround, you can have a single coloured background or a background consisting of horizontal stripes.
  • Buffer icons are visible when swiping up to Spotlight.
  • Buffer icons are visible when in the task switcher.
  • Homescreen parallax scrolling and transition effects will reveal the outline of the buffer icons. (Can be worked around by enabling "Use Reduced Motion" in the accessibility section of the Settings app.)
  • Buffer icons are visible momentarily when waking the phone.
  • Buffer icons can be launched.
  • Changing your homescreen wallpaper requires creating new buffer icons.

Are there plans to make a web-based version which is simpler to use?

It would be nice, but probably not. As mentioned above, this is more of a curiosity for the die-hard customisation junkies out there than something I see as being useful to most people.

Does the script support iOS 6 and earlier?

Yes, but only for the iPhone 4, 4S and iPod Touch 4G. Run the script with the --6 switch for these screen sizes to get iOS 6 icons. I can add iOS 6 support for other devices on request.

I don't understand how the command line works! If I send you a screenshot of my empty home screen, will you generate the icons for me?

Maybe. Just drop me a message.

I just upgraded to iOS 10 and my buffer icons are more visible

iOS 10 seems to place the background differently. If you take a new background screenshot and then run the script again to generate fresh icons, you'll be fine.

Sometimes an icon gets "stuck" after a fresh upload

Welcome to the wonderful world of iOS web caching. Unfortunately the way this works is a mystery to most people, but yes, an icon can get stuck even after the source page is updated. Right now the only solution is to either wait a few days and hope the cache refreshes, or upload your icons to a differently named directory.