Giter VIP home page Giter VIP logo

volumebar9's Introduction

VolumeBar9

A replacement for the disruptive, rounded-square volume HUD included with stock iOS. Only for jailbroken devices.

When you press the volume buttons, a small banner now appears at the top of the screen with a slider. This slider shows the current volume, is updated when the volume buttons are pressed, and can be moved to change the volume as well!

VolumeBar9 has many customizable options, from the colors of the banner and slider to interaction with the banner itself.

This project stems from my previous project, VolumeBar.

VolumeBar9 is confirmed to work on iOS 9.3.3, on an iPhone 6S set to the resolution of an iPhone 6S+. There doesn't seem to be a reason for it not to work on iOS 9.3.2 and below, but it has not been tested (yet), and it also hasn't been extensively tested on any other devices. iPads in particular may cause bugs concerning the bigger screens.

Cydia repo GitHub release

Features

Currently, VolumeBar9 is full of features that users have asked for. However, there's always room for improvement, so feel free to suggest more.

  • Interactive slider to control volume, in a small non-irritating banner
  • Works on both the ringer and the player volumes
    • Icons to differentiate between modes, or alternatively a mode label
  • Handles orientation change events and animates changing
  • Can be themed in many different ways to fit any device theme
    • Banner can be blurred in three different styles, or custom-colored
    • Slider track can be colored a color of your choice
  • Can be dismissed by a easy, user-controlled gesture
  • UI elements automatically change color to maximize contrast
  • Animation and time the banner appears can be customized

Screenshots

status+icons

status+customslider

normal+route

normal+handle+label+icons

normal+dropshadow

normal+crazycolors+handle+label

landscape+status

landscape+normal+customslider

banner_settings

animation_settings

Install

To install on a jailbroken iOS device, add my Cydia repo: cgm616.me/repo/. Then install the VolumeBar9 package.

It has a few dependencies: libcolorpicker and libobjcipc, which are both most likely installed already on your device.

Alternatively, you can install and setup theos, clone this repo, and build it and install it on your device with:

make do

In addition to both of those methods, deb files can be downloaded from the GitHub releases page. Then, they will need to be transferred to the device and installed using iFile, Filza, some other file manager, aptitude, or dpkg.

Changelog

Every new update pushed on my Cydia repo is also tagged and signed, which can be seen on the GitHub tags page.

These tags have small descriptions of changes, which are also copied below. Longer versions can be found on the GitHub releases page.

  • v0.4.1-beta | September 7, 2016
    • Add logging to debug a crash, see GitHub issue #1
  • v0.4.0-beta | September 3, 2016
    • Add adaptive slider color setting, see GitHub issue #2
    • Fix icons sometimes not showing correctly, see GitHub issue #12
    • Remove slide in animation on slider, see GitHub issue #13
    • Fix orientation problem on SpringBoard and iPad, see GitHub issue #5
    • Fix UI colors on custom white backgrounds
    • Change route button color with other UI, see GitHub issue #15
  • v0.3.4-beta | August 31, 2016
    • Fix Springboard crash when apps are opening, see GitHub issue #9
    • Fix app crash when apps are opening, see GitHub issue #7
  • v0.3.3-beta | August 29, 2016
    • Fix package depiction to point to the correct place
    • Add new method of updating depictions from README.md
  • v0.3.2-beta | August 28, 2016
    • Add package depiction
  • v0.3.1-beta | August 27, 2016
    • Fix and clarify language in preferences
  • v0.3.0-beta | August 27, 2016
    • Add icons to either side of slider and option
    • Reorganize preferences slightly
    • Fix some problems with slide to dismiss
    • Add other ways to dismiss slider
  • v0.2.0-beta | August 25, 2016
    • Fix orientation changes in apps
    • Start with correct orientation
    • Bar now resizes for orientation
    • Ringer volume slider now works correctly
  • v0.1.2-beta | August 23, 2016
    • Timer resets on volume change or slider touch
    • Status bar hides when the volumebar is shown, and shows after it disappears
  • v0.1.1-beta | August 13, 2016
    • Add ability to set custom slider track colors
  • v0.1.0-beta | (not tagged)
    • Initial version
    • Same functionality as VolumeBar, but updated to work on iOS 9

License

All of the code I have written in this project, which is most of it, along with some snippets from StackOverflow and otherwise, is licensed under the MIT License.

The full text of this License is below, contained in the LICENSE.md file, and available at choosealicense.com.

The MIT License (MIT)

Copyright (c) 2015 - 2016 Cole Graber-Mitchell / cgm616

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contributing

If you find something you can fix or otherwise make better, please feel free to do so. Another way to contribute is create GitHub issues for features you want and bugs you find. I need help testing the tweak on many different devices.

Fork the repo and create a pull request here on GitHub and I'll take a look. In your fork, add yourself to the contributors list below as well!

Contributors

volumebar9's People

Contributors

cgm616 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

bdx0

volumebar9's Issues

Changing color in settings doesn't work instantly

After using libcolorpicker to change any of the three color settings, the new color won't actually be used until a setting is changed again. This can be from opening the libcolorpicker again, or flip-flopping a different setting.

Pin bar to side with volume buttons option

Some people are asking for the volume bar to be pinned to the side with the volume buttons, so it's easy to slide up and down right after summoning it. I think it's a pretty good idea.

Orientation would just be fixed to that side. Maybe the slider icons would rotate when the orientation of the device changes so they're always the right way around?

Use HUD for Ringer silence

Currently, when the silence physical switch on the side of the device is switched, the normal HUD shows. This HUD should be replaced.

Volume slider weirdly animates in

The volume slider from MPVolumeView animates in from the left side when it's created. It's unintentional and doesn't look too good in my opinion.

Springboard orientation landscape makes banner small and offset

When the volume bar is set to appear on a rotated springboard, weird things happen. This doesn't happen in apps, and it doesn't happen when the banner appears in portrait mode then animates to rotate. Different things happen depending on the landscape mode.

  • Landscape left (home button on the left)
    The bar is either half the screen size, or the size it would be in protrait orientation. The bar is correctly at the top, but it sticks to the right side of the screen, not in the center.
  • Landscape right (home button on the right)
    The bar is nowhere to be seen. Completely gone.

Starting in landscape left on the springboard, by turning the device to landscape right, the bar will express the landscape right bug and vice-versa. When turned to portrait after starting in either landscape mode, the bar will grow to be too big (maybe landscape size) but correctly rotate and appear at the top of the screen.

Maybe this has something to do with the screen width and height being reported differently depending on what the springboard orientation is?

Adaptive slider colors

Add an option for adaptive slider colors depending on the status bar foreground and background color, like StatusVolX. Not sure on the exact design yet.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.