Browser extension for IEEE Student Branches, Chapters and other Organizational Units. It fills the IEEE vTools Create Event form for you, either from a pop-up form or from a Markdown (.md) file that holds all the event information.
Fork of GBAS-BCN/vTools-Helper (GPL-3.0), extended with Markdown import, a co-host, an editable OU list, and category/subcategory defaults.
| Function | Description |
|---|---|
| Markdown import | Pick a .md file in the modal; every field is filled from it (title, dates, category, location, speakers, description...). |
| PDF import | Pick meeting-minutes PDF; title, date/time, room, attendees and description are filled, the rest keeps your defaults. See Import from PDF. |
| Event template | Download/copy a ready template from the modal or from templates/event-template.md. |
| Interactive modal | Fill or correct any field by hand before pressing Autofill Form. Rich-text editor for description and speaker bios. |
| Category + Subcategory | All 6 vTools categories and their subcategories, dependent dropdown (disabled for Technical). Default set in Options. |
| Host / Co-Host | Choose from an editable OU list (Options). Co-host is reused on repeat autofill, so no duplicate blocks. |
| Location | In-Person, Virtual or Hybrid. Address, building, room, city, postal code, map URL, virtual info. Country/State picked by name. |
| Speakers | Any number of speakers: first/last/preferred name and bio. |
| Attendance | IEEE members / guests attending, default 0 (leave empty for future events). |
| Registration | Link, survey URL, registration type, custom registration questions (Text / Multiple Choice). |
| Tags / WIE | Default tags from Options plus per-event tags; WIE checkbox. |
| Options page | Defaults for host OU, email, cosponsor, OU list, co-host, timezone, location, tags, attending numbers, category/subcategory. |
| Export / Import settings | Options page buttons save your settings to a JSON file and load one back as your defaults. Handy to share one config across a team or browser. |
The extension is not on the Chrome Web Store. You load it yourself as an unpacked extension. It takes about one minute and works in every Chromium browser: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Chromium. (Firefox and Safari are not supported.)
Pick one:
- Download ZIP (easiest): on the GitHub page click Code → Download ZIP, then extract it. Do not load the
.zipitself. - Git:
git clone https://github.com/ieeeupsb/vTools-Helper.git
You should now have a folder that contains manifest.json directly inside it. That is the folder you will select. Keep it somewhere permanent (e.g. Documents/vTools-Helper): if you move or delete it, the extension stops working.
Type this in the address bar and press Enter:
| Browser | Address |
|---|---|
| Chrome | chrome://extensions |
| Edge | edge://extensions |
| Brave | brave://extensions |
| Opera | opera://extensions |
| Vivaldi | vivaldi://extensions |
Toggle Developer mode (top-right corner in Chrome/Brave, left sidebar in Edge). New buttons appear: Load unpacked, Pack extension, Update.
- Click Load unpacked.
- Select the folder that contains
manifest.json(not a parent folder, notsrc/). - Click Select Folder / Open.
The card vTools IEEE Event Autofill Assistant now appears in the list. If it shows a red Errors button, see Troubleshooting below.
Click the puzzle-piece icon in the toolbar, then the pin next to the extension, so the icon is always visible.
Right-click the extension icon → Options (or Details → Extension options). Set your OU list, host OU, co-host, location, time zone, tags, default category. Click Save.
- ZIP: download the new ZIP, extract over the old folder (same location).
- Git:
git pull. - Then in
chrome://extensionsclick the reload icon on the extension card, and press F5 on any open vTools tab.
Chrome may show "Disable developer mode extensions" on startup. Click the X / keep it. Do not click Disable.
| Problem | Fix |
|---|---|
Manifest file is missing or unreadable |
You selected the wrong folder. Select the one with manifest.json directly inside. |
Cannot select a .zip |
Extract it first. |
| Icon does nothing / no ⚡ Fill Event Form button | Be logged in to vTools and on https://events.vtools.ieee.org/tego_/event/create. Press F5 after loading or reloading the extension. |
| Extension disappeared after moving the folder | Load it again from the new location. |
| Work/school managed browser blocks it | Admin policy disables developer mode. Use a personal browser profile. |
| Options not saved | Click Save at the bottom of the Options page. |
- Log in to vTools, then click the extension icon. It opens
https://events.vtools.ieee.org/tego_/event/create. - Click the floating ⚡ Fill Event Form button.
- Either fill the modal by hand, or import a
.mdfile (see below). - Click Autofill Form and wait a few seconds. vTools loads states, subcategories and speaker blocks from the server, so filling is sequential. The modal closes when done.
- Review the page and submit the event yourself. The extension never submits for you.
Host, location, time zone and default tags come from the Options page, not from the Markdown file (the Markdown can override location and co-host).
Write each event in a .md file, import it in the modal, and the form is filled for you. Start from templates/event-template.md (also downloadable from the modal) and copy-edit the example files in examples/.
- Copy
templates/event-template.mdto a new file, e.g.my-workshop.md. - Edit the values after each
Key:. Delete the value to skip a field. - In vTools click ⚡ Fill Event Form, then under Import from Markdown (.md) choose your file. The modal fields fill in and any problem is shown as a warning.
- Check the modal, then click Autofill Form.
# Event
Title: My Event Title
Start: 2026-11-20 18:00
End: 2026-11-20 20:00
Category: Technical
Subcategory:
WIE: no
Tags: #AI #Workshop #City #IEEE
Registration Link:
Survey URL:
Co-Host OU:
Co-Host Email:
Location Type: In-Person
Address: 123 Example Street
Address 2:
Building:
Room:
City: Exampleville
Country: United States
State: California
Postal Code: 00000
Map URL:
Virtual Info:
IEEE Attending:
Guests Attending:
## Description
Write the event description here. Supports **bold**, *italic* and lists:
- first point
- second point
## Speaker 1
First Name: Jane
Last Name: Doe
Preferred Name: Jane
Bio:
Short biography of the speaker. Can have **bold**, *italic* and
- lists- Header lines are
Key: value, one per line. Empty value = skipped. - Key names are not case sensitive. Keep them spelled as in the table below.
- Dates are
YYYY-MM-DD HH:MM(24h). ## Descriptionstarts the description. It supports**bold**,*italic*,-lists and1.lists. It runs until the next##heading.## Speaker 1,## Speaker 2... start each speaker (add as many as you need).Bio:runs until the next##heading.<!-- comments -->are ignored.- Save the file as UTF-8 (accents are fine).
| Key | Notes |
|---|---|
Title, Start, End |
Required: Title and Start. If End is missing, it is Start + 2 h. |
Category |
Professional, Technical, Nontechnical, Administrative, Humanitarian, Pre-U STEM Program |
Subcategory |
Optional, matched by name (see below). Technical has none. |
WIE |
yes / no |
Tags |
e.g. #AI #Workshop #IEEE |
Registration Link, Survey URL |
URLs |
Co-Host OU, Co-Host Email |
Enables the co-host block |
Location Type |
In-Person, Virtual or Hybrid |
Address, Address 2, Building, Room, City, Postal Code, Country, State, Map URL |
Country and State by name, e.g. Portugal / Norte |
Virtual Info |
Link or instructions for virtual/hybrid events |
IEEE Attending, Guests Attending |
Numbers |
First Name, Last Name, Preferred Name, Bio |
Inside a ## Speaker N section |
| Category | Subcategories |
|---|---|
| Professional | Continuing Education, Professional Development, Industry Relations, Professional (Other) |
| Technical | none |
| Nontechnical | Social, Awards Dinner, Pre-University Activities, Nontechnical (Other) |
| Administrative | ExCom, Officer Training |
| Humanitarian | SIGHT, Other |
| Pre-U STEM Program | Camp, Career Day, Competition/STEM Fairs, Girls in STEM, Industry/Company Tour, Mentoring, Parent Program, Student Workshop, Teacher Workshop |
Matching ignores case, spaces and punctuation. Unknown values show a warning in the modal and are left unchanged.
templates/event-template.md: empty template to copy (same as the modal's "Download template" link)examples/technical-workshop.md: Technical, in-person, two speakersexamples/administrative-meeting.md: Administrative → ExComexamples/virtual-talk.md: Professional → Professional Development, virtualexamples/hybrid-social.md: Nontechnical → Social, hybridexamples/prestem-workshop.md: Pre-U STEM → Girls in STEM
All names, addresses, emails and OU codes in them are fake. Replace them with your own.
In the assistant modal, pick a PDF under Import from PDF (meeting minutes). The extension reads the text, guesses the fields and fills them. Anything the PDF does not contain keeps your default from the Options page. Always review the fields before Autofill Form.
| Found in the PDF | Fills |
|---|---|
First header lines, or a Planning: / Topic: / Title: line |
Title |
Date (09/11/26, 2026-11-09, 22 October 2026, 22 de Outubro de 2026) |
Start / End date |
Time range (10:00 - 11:30, 15:00-17:00) |
Start / End time |
Sala ... / Room ... / Location: line |
Room (Location Type = In-Person) |
People: (4) or a PARTICIPANTS list (plus special guests) |
IEEE Attending + participant names in the description |
Other sections (Abstract, TOPICS, SUMMARY, TASKS...) with bullets or numbered lists |
Description (nested lists kept) |
Not in the PDF (category, host, tags, location address, WIE...) = default from Options. Works with text PDFs only, not scanned images. If no end time is found, it is start + 2 h.
PDF templates (same fonts, logos and layout as real minutes, all text replaced by fake data). Copy their structure for your own minutes:
examples/meeting-minutes-project.pdf: Times New Roman style. Blue centered header with date, logos,Planning:,Time:,People: (n)numbered list,Abstract:bullets with sub-bullets.examples/meeting-minutes-board.pdf: Oswald / Arial style. Title lines, date, time range, room,Led by:,PARTICIPANTES,TÓPICOS ABORDADOS,RESUMO DA REUNIÃO(numbered with a./b. sub-items) andTAREFASwith checkbox.
Bundled library: pdf.js (Apache-2.0) in src/vendor/. It is loaded only when you pick a PDF.
Header, Footer, Agenda and Time Zone (time zone comes from Options), and anything the form needs beyond the fields above. Fill those by hand.
.
├── manifest.json # Manifest V3 config (load this folder as unpacked)
├── src/
│ ├── background.js # Service worker: toolbar click → open create page / modal
│ ├── content.js # Modal, Markdown apply, form population logic
│ ├── md-import.js # Markdown parser + template (also runs in Node)
│ ├── pdf-import.js # PDF text → Markdown (meeting minutes)
│ ├── vendor/ # pdf.js (Apache-2.0), loaded on demand
│ ├── options.html # Preferences page
│ ├── options.js # Preferences storage + logic
│ └── styles.css # Button, modal and editor styling
├── templates/ # Empty event template
├── examples/ # Filled sample events + 2 sample meeting-minutes PDFs (fake data)
└── LICENSE # GPL-3.0
GPL-3.0. See LICENSE.