Skip to content

SwiftBar plugin to display the number of available bikes and docks at your chosen Vélib stations

License

Notifications You must be signed in to change notification settings

lehenandmartin/velibar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

VeliBar

VeliBar is a SwiftBar plugin that displays the number of available bikes and docks at your chosen Vélib stations in the menu bar.

Screenshot

Features

  • Display of available mechanical and electric bikes.
  • Display of available docks for returning bikes.
  • Automatic information refresh each time the menu is opened.

Prerequisites

  • macOS with SwiftBar installed.
  • PHP installed on your machine (VeliBar has been tested with PHP 8.3).

Installation

  1. Download the plugin: Download VeliBar.php from the releases page or clone the repository directly.

  2. Install SwiftBar: If you haven't already, download and install SwiftBar from its GitHub page.

  3. Place the plugin in the SwiftBar plugin folder:

    • Open SwiftBar and go to Preferences.
    • Locate the plugin folder and place the VeliBar.php file there.

Configuration

PHP Path

If the path to PHP on your system is different from /opt/homebrew/bin/php, you'll need to adjust the first line of the script. Here's how:

  1. Find the PHP path: Open Terminal and type which php. This will give you the exact path of PHP on your system.

  2. Edit the script: Open VeliBar.php in your favorite text editor and replace the first line with #!/path/found/php, using the path found in the previous step.

Changing Stations to Monitor

By default, the plugin monitors certain stations. To change which stations are monitored:

  1. Find station codes: Visit www.velib-metropole.fr/map to find the codes of the stations you want to monitor.

  2. Edit the script: Open VeliBar.php in your text editor and locate the line starting with $stationsCode =. Replace the existing station codes with the ones you've chosen.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

About

SwiftBar plugin to display the number of available bikes and docks at your chosen Vélib stations

Topics

Resources

License

Stars

Watchers

Forks

Languages