https://github.com/fxwx23/volumizer

Volumizer replaces the default volume popup with a simple progress bar.
https://github.com/fxwx23/volumizer

cocoapods ios mpvolumeview swift swift-library swift3 swift4 volume-popup

Last synced: 12 months ago
JSON representation

Volumizer replaces the default volume popup with a simple progress bar.

• Host: GitHub
• URL: https://github.com/fxwx23/volumizer
• Owner: fxwx23
• License: mit
• Created: 2017-03-20T10:08:54.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2019-04-20T06:32:43.000Z (about 7 years ago)
• Last Synced: 2025-04-08T15:50:48.614Z (about 1 year ago)
• Topics: cocoapods, ios, mpvolumeview, swift, swift-library, swift3, swift4, volume-popup
• Language: Swift
• Homepage:
• Size: 204 KB
• Stars: 46
• Watchers: 2
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: Readme.md
  • License: license

Awesome Lists containing this project

README

          
# Volumizer

[![Platform](https://img.shields.io/cocoapods/p/Volumizer.svg?style=flat)](https://github.com/fxwx23/Volumizer)

[![Language](https://img.shields.io/badge/language-swift-orange.svg?style=flat)](https://developer.apple.com/swift)

[![Cocoapods Compatible](https://img.shields.io/cocoapods/v/Volumizer.svg)](https://cocoapods.org/pods/Volumizer)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/fxwx23/Volumizer/master/license)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md#pull-requests)

**Volumizer** replaces the system volume popup with a simple progress bar.

Before | After(No Notch) | After (With Notch)

--- | --- | ---

![good](https://raw.githubusercontent.com/fxwx23/Volumizer/master/Screenshots/before.png) | ![good](https://raw.githubusercontent.com/fxwx23/Volumizer/master/Screenshots/after.png) | ![good](https://raw.githubusercontent.com/fxwx23/Volumizer/master/Screenshots/after_iphonex.png) 

### Features

- Swift 5

- Hide the system volume HUD typically displayed on volume button presses

- Show a simple progress bar like Instagram's iOS app does

- Support iPhoneX, XS, XS Max, XR

- Well easy to customize appearance

- Only support `portrait` mode

## Installation

##### [CocoaPods](https://cocoapods.org) 

```ruby

platform :ios, '10.0'

use_frameworks!

pod 'Volumizer'

```

##### [Carthage](https://github.com/Carthage/Carthage)

```

github "fxwx23/Volumizer"

```

##### Manually

Drag the `Volumizer` folder into your project and link the `MediaPlayer` and `AVFoundation` frameworks to your project.

## Usage

Use of `Volumizer` is a simple way with one line. Just call `configure()` after set a window at least.

```swift

Volumizer.configure()

```

You can customize the bar's appearance with `VolumizerAppearanceOption`.

```swift

/**

public enum VolumizerAppearanceOption {

   case overlayIsTranslucent(Bool) default is `true`.

   case overlayBackgroundBlurEffectStyle(UIBlurEffectStyle) default is `.extraLight`.

   case overlayBackgroundColor(UIColor) default is `.white`.

   case sliderProgressTintColor(UIColor) default is `.black`.

   case sliderTrackTintColor(UIColor) default is `.lightGray.withAlphaComponent(0.5)`

}

*/

let options: [VolumizerAppearanceOption] = [ .overlayIsTranslucent(true),

                                             .overlayBackgroundBlurEffect( .extraLight),

                                             .overlayBackgroundColor( .white),

                                             .sliderProgressTintColor( .black)]

let volumizer = Volumizer.configure(options)

/// To change options based on view's current appearance, call `change(options:_)` .

volumizer.change(options: otherOptions)

```

If you want to release `volumizer` 's window, please call `resign()`. Once you released, the system volume popup will be shown again.

```swift

volumizer.resign()

```

## WIP

- [ ] support `landscape` mode.

- [ ] support [SPM]().

- [ ] manage window level to be below `UIWindowLevelAlert` .

- [ ] `Objective-C` compatible.

## License

This project is under the MIT license.